Installation

Norri is not yet released, so treat this page as a preview rather than live installation instructions. The intended quickest path for most home-server users will be Docker Compose, because it keeps the server, configuration, and media paths in one place and is easy to update or remove later.

Unraid and desktop installers are planned as simpler routes for people who prefer those environments, but the Docker Compose path is the baseline this page uses for the first-install preview.

Docker Installation

The recommended preview path for running Norri is Docker Compose.

1. Create a directory for Norri:

mkdir norri && cd norri

2. Create a docker-compose.yml file:

version: '3.8'
services:
  norri:
    image: norri/server:latest
    container_name: norri
    ports:
      - "8096:8096"
    volumes:
      - ./config:/config
      - /path/to/media:/media:ro
    environment:
      - TZ=Europe/London
    restart: unless-stopped

3. Start Norri:

docker-compose up -d

4. Access Norri at http://localhost:8096

Unraid Installation

The Unraid route is expected to be the simplest option for users who already run their media server on Unraid. When Norri is available there, the flow should be:

1. Open the Apps tab in Unraid
2. Search for “Norri”
3. Click Install
4. Configure your media paths
5. Click Apply

Norri will be available at http://your-unraid-ip:8096.

Desktop Application

Desktop builds are also part of the planned installation story, but they are not available yet. When release builds are ready, this section will link to the supported macOS, Windows, and Linux downloads and explain what is bundled with each one.

Initial Setup

After installation, open Norri in your browser to complete the setup wizard:

1. Create admin account. Set up your administrator username and password
2. Add media libraries. Point Norri to your media folders
3. Configure settings. Set your preferred language, transcoding options, etc.

Next Steps

Once installed, follow the First Steps guide to configure your server.