Skip to content

Installation

import { Tabs, TabItem } from ‘@astrojs/starlight/components’;

Norri can be installed using Docker, on Unraid via Community Apps, or as a standalone desktop application.

Choose Your Platform

### Docker Installation
The recommended way to run Norri is using Docker Compose.
1. Create a directory for Norri:
```bash
mkdir norri && cd norri
```
2. Create a `docker-compose.yml` file:
```yaml
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:
```bash
docker-compose up -d
```
4. Access Norri at `http://localhost:8096`
### Unraid Installation
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
Download the desktop app for your operating system:
- **macOS**: Download the `.dmg` file
- **Windows**: Download the `.exe` installer
- **Linux**: Download the `.AppImage` or `.deb` package
The desktop app includes PostgreSQL bundled — no separate database setup required.

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.