Advanced, Hidden Server Settings

There are a number of advanced, hidden Plex Media Server settings, some of which are not available from the normal interface. Instead, they're available where your Plex Media Server stores its own settings. The vast majority of users will never need to alter these settings. We recommend exercising caution when considering altering these settings.

If you get into trouble, you can reset the Server to default by deleting the preferences file or Plex entries in the Windows Registry. If you delete the preference file, you will need to reset any changes you've made and you will also lose any server shares or Mobile Sync/Cloud Sync items you may have. Deleting the preferences file will not affect your Plex Media Server library database.

Locating the Advanced, Hidden Settings

Windows

On Windows, the preferences are available in the registry. To access settings related to Plex Media Server:

  1. Open the "regedit" application
  2. Navigate to Computer\HKEY_CURRENT_USER\Software\Plex, Inc.\Plex Media Server
  3. Create a new entry named as per the options below and add the correct value, or else edit an existing value

Related Page: How to use Registry Editor

macOS / OS X

On Mac computers (macOS or OS X), the preferences are available under your computer user account library preferences.

Using the Finder's "Go" menu, select Go To Folder... then enter the following in the dialog box that pops up:

~/Library/Preferences/com.plexapp.plexmediaserver.plist

You can then open that file (which is really XML) in a text editor to add new settings or edit existing ones.

Warning!: If you use a text editor to make changes, you will need to reboot the computer to have the changes take effect (since the OS caches the preferences).

Alternatively, you can open the "Terminal" application and run commands to add/alter values.:

defaults write com.plexapp.plexmediaserver <optionname> <value>
defaults write com.plexapp.plexmediaserver <optionname> -boolean <Value>

Linux

Preferences File

On Linux the options are available in a XML file called Preferences.xml, which is located in your Plex Media Server data directory.

Related Page: Where is the Plex Media Server data directory located?

Add a new XML attribute with the name of the option and the value. e.g.:

<?xml version="1.0" encoding="utf-8"?>
<Preferences BlacklistedBundle="" newoption="withvalue"/>

Note that the Preferences tag can contain a lot of options already.

Syslog Option

In addition to the Preferences file, as of Plex Media Server 0.9.6.6, it's also possible to enable syslogging. This is done via a configuration variable: PLEX_MEDIA_SERVER_USE_SYSLOG=true

To set the variable, it has to be added to the configuration file of Plex Media Server. Here is where to place it on various Linux distributions:

  • CentOS/Fedora: Add export PLEX_MEDIA_SERVER_USE_SYSLOG=true under /etc/sysconfig/PlexMediaServer
  • ReadyNAS: Add export PLEX_MEDIA_SERVER_USE_SYSLOG=true under /etc/init.d/plexserver
  • Synology: Add PLEX_MEDIA_SERVER_USE_SYSLOG=true under /var/packages/Plex Media Server/scripts/start-stop-status
  • Ubuntu: Add PLEX_MEDIA_SERVER_USE_SYSLOG=true under /etc/default/plexmediaserver

After adding the variable, restart Plex Media Server. Logs from Plex Media Server will then be output to syslog instead of normal server logging.

Available Preferences

Name Possible Values Descriptions Example
AlbumSort string A field:direction value for the default album sort. "year", "title", etc. (PMS 1.4.1+ has UI setting per library/per artist) year:desc
allowMediaDeletion 1/0   1
allowedNetworks string with ip/netmask,ip/netmask A list of networks that are allowed to access PMS without authentication. Must be listed with full subnet. 192.168.1.0/255.255.255.0,10.10.10.0/255.255.255.0
ApertureLibraryXmlPath path   ~/Pictures/Aperture Library.aplibrary/ApertureData.xml
ApertureSharingEnabled 1/0   1
AppCastUrl 1/0   1
ArticleStrings string comma-separated list of words considered to be grammatical articles that are removed in sort title the, das, der, a, an, el, la
autoEmptyTrash 1/0   1
autoScanMusicSections 1/0   1
BackgroundTranscodeLowPriority 1/0 Makes background transcodes lower priority than streaming when set to 1 1
BonjourEnabled 1/0 Enables Bonjour discovery when set to 1 1
collectUsageData 1/0   1
disableCapabilityChecking 1/0 Disables the channel capability checking if set to 1 1
DlnaDeviceDiscoveryInterval 1/0   1
DlnaEnabled 1/0 Disables DLNA server if set to 0 0
DlnaPlatinumLoggingLevel string Sets level for the Neptune DLNA logging OFF
DlnaTraceVerbose 1/0   1
EnableIPv6 1/0 Turn on IPv6 support for the server 0
FriendlyName string Defines the name shown in Plex portal and on clients My Media Center
FSEventLibraryUpdatesEnabled 1/0   1
GdmEnabled 1/0 Enables GDM discovery when set to 1 1
higherBitrate3G 1/0   1
iPhotoLibraryXmlPath path   ~/Pictures/iPhoto Library/AlbumData.xml
iPhotoSharingEnabled 1/0   1
iTunesLibraryXmlPath path   ~/Music/iTunes/iTunes Library.xml
iTunesSharingEnabled 1/0   1
LocalAppDataPath path Changes location of Local Data /Volumes/BigDisk/PlexData
logDebug 1/0 Disables debug logging if set to 0 0
LogNumFiles integer Number of past log files to retain (default is 5) 10
LogVerbose 1/0   0
ManualPortMappingMode 1/0 Enable/disable manual port mapping 1
ManualPortMappingPort integer The manual port to use 32400
secureConnections 0/1/2 How the server handles secure connections 0: Required
1: Preferred (default)
2: Disabled
ScheduledLibraryUpdatesEnabled 1/0   1
ScheduledLibraryUpdateInterval integer Number of seconds between scans 1800
TranscoderDefaultDuration integer duration in minutes 120
TranscoderH264OptionsOverride options Options appended to -x264opts passed to transcoder weightb=0:b-adapt=2
TranscoderH264Preset string The x264 preset to use when transcoding veryfast
TranscoderLogLevel string Log level for the Plex transcoder error (default)
verbose
TranscoderPhotoFileSizeLimitMiB integer Maximum photo size to be tagged or transcoded (in mebibytes) 100 (default)
TranscoderTempDirectory path Location to write temporary transcode segments /Volumes/Media/MyTempDirectory/