Installation

Norri runs in Docker on your computer or NAS. One container includes the server, web app, database, and transcoding tools. Choose one method below; each guide includes the complete configuration.

Choose a method

• Docker run — recommended for the quickest start. Choose your computer and GPU, then copy one complete command.
• Docker Compose — save your configuration in a file for changes and updates. Also suitable for NAS stack editors.
• macOS — a complete Compose guide for Intel and Apple Silicon Macs.
• Unraid — install from Community Apps, with your existing media shares and optional GPU access.

Already using a container manager? See the Docker reference for the required settings, additional folders, updates, and backups.

Before you start

Install Docker, or enable Docker in Unraid, and have your media folders ready. The guides mount your media read-only and keep Norri’s database and application data in separate persistent volumes.

On Windows, you can use Docker Desktop with Linux containers or Docker Engine inside WSL. The Windows examples use Docker Desktop and PowerShell. For Docker Engine in WSL, use the Linux examples in your WSL terminal with Linux folder paths. GPU access depends on your host, driver, and Docker setup; each guide explains which option to use.

On a Mac, the guide uses Docker Desktop. The current image is AMD64; Apple Silicon runs it through emulation.

After installation

Open your server’s address and follow Setting up your server. You can use the web app immediately after setup, or connect a client app.

Beta information covers current releases, availability, and limitations. Join the Norri Discord for help, announcements, and discussion.