Settings
Last updated
Was this helpful?
Last updated
Was this helpful?
This is your Overseerr API key, which can be used to integrate Overseerr with third-party applications. Do not share this key publicly, as it can be used to gain administrator access!
If you need to generate a new API key for any reason, simply click the button to the right of the text box.
If you aren't a huge fan of the name "Overseerr" and would like to display something different to your users, you can customize the application title!
Set this to the externally-accessible URL of your Overseerr instance.
You must configure this setting in order to enable password reset and emails.
If you have Overseerr behind a , enable this setting to allow Overseerr to correctly register client IP addresses. For details, please see the .
This setting is disabled by default.
This is an advanced setting. We do not recommend enabling it unless you understand the implications of doing so.
If you do not use Overseerr integrations with third-party applications to add/modify/delete requests or users, you can consider enabling this setting to protect against malicious attacks.
One caveat, however, is that HTTPS is required, meaning that once this setting is enabled, you will no longer be able to access your Overseerr instance over HTTP (including using an IP address and port number).
If you enable this setting and find yourself unable to access Overseerr, you can disable the setting by modifying settings.json in /app/config.
This setting is disabled by default.
When enabled, Overseerr will proxy and cache images from pre-configured sources (such as TMDB). This can use a significant amount of disk space.
Images are saved in the config/cache/images and stale images are cleared out every 24 hours.
You should enable this if you are having issues with loading images directly from TMDB in your browser.
Set the default display language for Overseerr. Users can override this setting in their user settings.
These settings filter content shown on the "Discover" home page based on regional availability and original language, respectively. Users can override these global settings by configuring these same options in their user settings.
When enabled, media which is already available will not appear on the "Discover" home page, or in the "Recommended" or "Similar" categories or other links on media detail pages.
Available media will still appear in search results, however, so it is possible to locate and view hidden items by searching for them by title.
This setting is disabled by default.
When enabled, users will be able to submit requests for specific seasons of TV series. If disabled, users will only be able to submit requests for all unavailable seasons.
This setting is enabled by default.
When enabled, users who have configured passwords will be allowed to sign in using their email address.
When disabled, Plex OAuth becomes the only sign-in option, and any "local users" you have created will not be able to sign in to Overseerr.
This setting is enabled by default.
This setting is enabled by default.
Select the request limits you would like granted to users.
Note that users with the Manage Users permission are exempt from request limits, since that permission also grants the ability to submit requests on behalf of other users.
Select the permissions you would like assigned to new users to have by default upon account creation.
If you have Overseerr installed on the same network as Plex, you can set this to the local IP address of your Plex server. Otherwise, this should be set to a valid hostname (e.g., plex.myawesomeserver.com).
This value should be set to the port that your Plex server listens on. The default port that Plex uses is 32400, but you may need to set this to 443 or some other value if your Plex server is hosted on a VPS or cloud provider.
Enable this setting to connect to Plex via HTTPS rather than HTTP. Note that self-signed certificates are not supported.
Note that you will need to enter the full path to the web app (e.g., https://plex.myawesomeserver.com/web).
In this section, simply select the libraries you would like Overseerr to scan. Overseerr will periodically check the selected libraries for available content to update the media status that is displayed to users.
If you do not see your Plex libraries listed, verify your Plex settings are correct and click the Sync Libraries button.
Overseerr will perform a full scan of your Plex libraries once every 24 hours (recently added items are fetched more frequently). If this is your first time configuring Plex, a one-time full manual library scan is recommended!
Only v3 Radarr/Sonarr servers are supported! If your Radarr/Sonarr server is still running v2, you will need to upgrade in order to add it to Overseerr.
At least one server needs to be marked as "Default" in order for requests to be sent successfully to Radarr/Sonarr.
If you have separate 4K Radarr/Sonarr servers, you need to designate default 4K servers in addition to default non-4K servers.
Only select this option if you have separate non-4K and 4K servers. If you only have a single Radarr/Sonarr server, do not check this box!
Enter a friendly name for the Radarr/Sonarr server.
If you have Overseerr installed on the same network as Radarr/Sonarr, you can set this to the local IP address of your Radarr/Sonarr server. Otherwise, this should be set to a valid hostname (e.g., radarr.myawesomeserver.com).
This value should be set to the port that your Radarr/Sonarr server listens on. By default, Radarr uses port 7878 and Sonarr uses port 8989, but you may need to set this to 443 or some other value if your Radarr/Sonarr server is hosted on a VPS or cloud provider.
Enable this setting to connect to Radarr/Sonarr via HTTPS rather than HTTP. Note that self-signed certificates are not supported.
Enter your Radarr/Sonarr API key here. Do not share these key publicly, as they can be used to gain administrator access to your Radarr/Sonarr servers!
You can locate the required API keys in Radarr/Sonarr in Settings → General → Security.
If you have configured a URL base for your Radarr/Sonarr server, you must enter it here in order for Overseerr to connect to those services!
You can verify whether or not you have a URL base configured in your Radarr/Sonarr server at Settings → General → Host. (Note that a restart of your Radarr/Sonarr server is required if you modify this setting!)
Select the default settings you would like to use for all new requests. Note that all of these options are required, and that requests will fail if any of these are not configured!
If the hostname or IP address you configured above is not accessible outside your network, you can set a different URL here. This "external" URL is used to add clickable links to your Radarr/Sonarr servers on media detail pages.
Enable this setting if you would like to scan your Radarr/Sonarr server for existing media/request status. It is recommended that you enable this setting, so that users cannot submit requests for media which has already been requested or is already available.
Enable this setting to have Radarr/Sonarr to automatically search for media upon approval of a request.
Overseerr performs certain maintenance tasks as regularly-scheduled jobs, but they can also be manually triggered on this page.
Overseerr also caches requests to external API endpoints to optimize performance and avoid making unnecessary API calls. If necessary, the cache for any particular endpoint can be cleared by clicking the "Flush Cache" button.
CSRF stands for . When this setting is enabled, all external API access that alters Overseerr application data is blocked.
When enabled, users with access to your Plex server will be able to sign in to Overseerr even if they have not yet been imported. Users will be automatically assigned the permissions configured in the setting upon first sign-in.
Unless an is configured, users are granted these global request limits.
If is enabled, any user with access to your Plex server will be able to sign in to Overseerr, and they will be granted the permissions you select here upon first sign-in.
This setting only affects new users, and has no impact on existing users. In order to modify permissions for existing users, you will need to .
To set up Plex, you can either enter your details manually or select a server retrieved from . Press the button to the right of the "Server" dropdown to retrieve available servers.
The Play on Plex buttons on media pages link to items on your Plex server. By default, these links use the hosted from plex.tv, but you can provide the URL to the web app on your Plex server and we'll use that instead!
Please see for details on configuring and enabling notifications.