Configuration Options
Use Settings in the web app to change playback preferences and server behavior. Administrator settings affect the server; personal playback settings apply to your account or web clients as described below.
See Environment Variables for deployment settings.
Host port
Go to Settings → General → Network. Host port defaults to 11423.
If you change Docker’s host port, enter the new number here and click Save host port. For a mapping of 12080:11423, enter 12080. Keep the container port at 11423.
The setting records the external host port. It accepts whole numbers from 1 to 65535 and survives restarts. Change the mapping in Docker first; saving here does not change Docker or restart Norri.
See Installation for the steps to change the mapping.
Transcoding settings
Go to Settings → Transcoding as an admin to change these values.
| Setting | Default | What it does |
|---|---|---|
| Max Sessions Per User | 5 | Maximum active playback sessions one user can start. |
| Max Global Sessions | 10 | Maximum active playback sessions across the server. |
| Transcode Idle Timeout (seconds) | 300 | How long a transcode survives without activity before Norri stops that conversion work. |
| Active Playback Idle Timeout (seconds) | 300 | How long a playing session survives after the app stops checking in. |
| Paused Playback Idle Timeout (seconds) | 86400 | How long a paused session survives after the app stops checking in. The default is 24 hours. |
| Buffer Ahead (seconds) | 60 | How far ahead Norri prepares a transcoded stream. |
| Hardware Acceleration | Auto-detect | Choose Auto-detect, a detected GPU, or CPU software transcoding. The saved choice applies after a server restart. Use a detected device when selecting a specific GPU. |
| Subtitle Burn Mode | Auto | Choose Auto, Always Burn In, or Never Burn In to control when subtitles are rendered into the video. |
| Burn In Styled Subtitles | On | Preserve ASS/SSA styling through burn-in when the client cannot render it directly. Compatible clients can receive styled subtitles without burn-in. |
| Prefer External Subtitles | Off | When enabled, matching sidecar subtitle files win over embedded subtitle tracks during automatic selection. |
| Enable HDR Tone Mapping | On | When enabled, HDR sources are tone-mapped to SDR for clients that do not support the source HDR format. |
Timeout values are in seconds.
Playback preferences
Go to Settings → Playback to change playback preferences. Admins can also set server defaults in Settings → General → Default Playback Preferences.
| Setting | Description |
|---|---|
| Preferred Audio Language | Selects matching audio automatically when available. |
| Preferred Subtitle Language | Selects matching subtitles when subtitle mode enables them. |
| Subtitle Mode | Controls when subtitles are selected automatically. |
| Prefer SDH | Prefers SDH or CC subtitle tracks over standard subtitles in the same language. |
| Audio Output | Sets the maximum output channel layout for new movie and episode playback: Inherit, Stereo, 5.1, or 7.1. Inherited defaults can use automatic detection. It does not create surround sound from a stereo source. |
These controls apply to your web clients. Inherited values follow your account setting, or the server default when your account has no override. Audio Output changes apply the next time you start a movie or episode; they do not change an already-playing session.
Auto-advance
Auto-advance plays the next episode after the current episode ends. The server default is Off. Its account and web settings are saved separately:
| Level | Where to change it | How it applies |
|---|---|---|
| Server default | As an admin, open Settings → General → Default Playback Preferences, set Default Auto-Advance, and click Save Changes. | Used when the account and client both inherit. |
| Account default | Open Settings → Playback → Auto-advance, choose Inherit, On, or Off under Account default, and click Save account setting. | Overrides the server default across your clients. Inherit follows the server. |
| Web override | In the same section, choose Inherit, On, or Off under Web clients, and click Save web setting. | Overrides your account default in all web browsers signed in to your account. Inherit follows your account, or the server when your account also inherits. |
The section shows the effective web setting and where it comes from. For example, keep your account default Off and set Web clients to On to enable auto-advance in your web browsers.
The player’s Settings → Auto-Advance → Enabled switch changes this same web override. Choose Use inherited setting in the player to clear it. Earlier browser-only on/off choices are not carried over; choose On in Settings or turn on Enabled in the player to enable auto-advance.
See Video Player for countdown and cancellation controls.
Local integrations
For integrations that read or change settings through the API, see API Reference. You do not need the API to configure Norri in the web app.