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 items you may have. Deleting the preferences file will not affect your Plex Media Server library database.
Locating the Advanced, Hidden Settings
On Windows, the preferences are available in the registry. To access settings related to Plex Media Server:
- Open the “regedit” application
- Navigate to
HKEY_CURRENT_USER/Software/Plex, Inc./Plex Media Server
- Create a new entry named as per the options below and add the correct value, or else edit an existing value
When creating the registry entry, be sure to choose the correct type:
- String, path, or other text:
- Integer or boolean:
DWORD (32-bit) 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:
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 then 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>
defaults write com.plexapp.plexmediaserver LogNumFiles 10
defaults write com.plexapp.plexmediaserver FriendlyName "My Media Server"
defaults write com.plexapp.plexmediaserver LogVerbose -bool FALSE
The Plex Media Server folder which contains the
Preferences.xml file for the NVIDIA SHIELD is not in a user accessible location by default. See our “Moving server data storage location on NVIDIA SHIELD” article for information on how to move it to an accessible location. Once it’s accessible, you can use the instructions for “Linux” below to adjust the “Preferences.xml” 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.
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:
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
- ReadyNAS: Add
- Synology: Add
/var/packages/Plex Media Server/scripts/start-stop-status
- Ubuntu 15 (and older): Add
- Ubuntu 16 (and newer): Add
After adding the variable, restart Plex Media Server. Logs from Plex Media Server will then be output to syslog instead of normal server logging.
field:directionvalue for the default album sort. “year”, “title”, etc. (PMS 1.4.1+ has UI setting per library/per artist).
- Set whether the owner of the server will be allowed to delete media files from disk.
- string with ip/netmask,ip/netmask
- A list of networks that are allowed to access PMS without authentication. Must be listed with full subnet.
- A comma-separated list of words considered to be grammatical articles, which are removed in sort titles.
the, das, der, a, an, el, la
- Sets whether the “trash” is emptied automatically at the end of a library scan.
- Makes background transcodes have a lower priority than active streaming when set to 1.
- Determine how often (in seconds) DLNA discovery is performed.
- Set whether DLNA server is enabled.
- Sets level for the separate, “Neptune DLNA” logging.
- Determines whether Plex Media Server must be claimed/signed-in to access it (default is 1/true).
- Turn on IPv6 support for the server.
- Defines the friendly name for the Plex Media Server, commonly shown in player apps.
My Media Server
- Determine whether library scans are automatically initiated when library folder changes are detected.
- When changes to library folders are detected, only scan the folder that changed (requires FSEventLibraryUpdatesEnabled also be enabled).
- Enables GDM discovery for the server, from other players on the network when set to 1.
- For video preview thumbnails, sets how often (in seconds) we create the thumbnail (default is 2).
- When generating video preview thumbnails for playback, only look at keyframes in the video. Greatly speeds up processing and reduces CPU usage (default is 1).
- The path to the iTunes library XML file.
- Determine whether the server tries to connect with a local iTunes installation.
- Set the location of of the Plex Media Server data directory (Windows only). (Default is “C:\Users\[ComputerUser]\AppData\Local\Plex Media Server”)
- Sets whether “debug” logging is enabled.
- Set Plex Media Server to log memory use and the system total used memory in Plex Media Server logs. A server restart is required for the change to take effect. Not recommended for normal usage. Requires PMS v1.20.2 or newer. (Not available for FreeBSD or NVIDIA SHIELD.) (Default is 0)
- Number of past log files to retain (default is 5).
- Sets whether “verbose” logging is enabled. This is not recommended for normal usage. (Default is 0)
- Sets how many threads can be used for long-running jobs, such as Sonic Analysis (Default is half the total threads for the processor)
- Determine whether the server is set to use port mapping for Remote Access.
- The manual port to use for Remote Access (requires ManualPortMappingMode to also be enabled).
- When playing a Radio or Smart Shuffle, Plex prefers to include tracks that have not been played recently. This sets that “recent” period (default is 2).
- Controls how many “genre”, “style”, or “mood” radios are exposed, on clients that support those radio types (default is 50).
- How the server handles secure connections.
1: Preferred (default),
- Determine whether PMS sends crash reports when launching the server after a crash.
- Sets whether the server will initiate library scans on a set interval.
- Number of seconds between library scans (requires ScheduledLibraryUpdatesEnabled to be enabled).
- The default duration (in minutes) the transcoder will work “ahead” of current playback.
120(120 is the default if nothing set)
- The x264 preset to use when transcoding.
- The log level for the Plex transcoder itself.
- Maximum photo size to be tagged or transcoded (in mebibytes).
- Location where the temporary transcode segments are written.