Advanced, Hidden Server Settings

There are a number of advanced, hidden Plex Media Server settings, some 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 Library database.

Mac OS X
File Location: ~/Library/Preferences/com.plexapp.plexmediaserver.plist

On OSX you change the preferences with the help of the defaults command:
 defaults write com.plexapp.plexmediaserver <optionname> <value>
 defaults write com.plexapp.plexmediaserver <optionname> -boolean <Value>

On Windows the preferences are available in the registry.
Open regedit and navigate to Computer\HKEY_CURRENT_USER\Software\Plex, Inc.\Plex Media Server
Create a new string value entry named as per the options below, and add the correct value

On Linux the options are available in a XML file called Preferences.xml in $PLEX_APPLICATION_SUPPORT_DIRECTORY/Plex media Server
This path resolves to the following on the different distributions:

Ubuntu/Fedora - /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Preferences.xml
Synology - /volume1/Plex/Library/Application Support/Plex Media Server/Preferences.xml
QNAP - /share/MD0_DATA/.qpkg/PlexMediaServer/Library/Plex Media Server/Preferences.xml
unRAID -
ReadyNAS - /c/.plex/Library/Application Support/Plex Media Server/Preferences.xml

Add a new XML attribute with the name of the option and the value like this
 <?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 its also possible to enable syslogging. This is done via the newly introduced variable:
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 flavors:
Add the PLEX_MEDIA_SERVER_USE_SYSLOG=true variable to:
Ubuntu - /etc/default/plexmediaserver (add: PLEX_MEDIA_SERVER_USE_SYSLOG=true)
CentOS/Fedora - /etc/sysconfig/PlexMediaServer (add: export PLEX_MEDIA_SERVER_USE_SYSLOG=true)
Synology - /var/packages/Plex Media Server/scripts/start-stop-status
unRAID -
ReadyNAS - /etc/init.d/plexserver (add: export PLEX_MEDIA_SERVER_USE_SYSLOG=true)
After adding the variable restart Plex Media Server and it will put Plex Media Server logs to syslog instead of Plex logs.

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.,
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
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
TranscoderTempDirectory path Location to write temporary transcode segments /Volumes/Media/MyTempDirectory/