Unraid Installation

Run OmniLux on Unraid using Docker.

Prerequisites

• Unraid 6.12+
• Community Applications plugin installed
• A share for OmniLux app data
• Media shares already configured

Installation via Docker Compose

1. Create the app data directory

In the Unraid terminal or SSH:

mkdir -p /mnt/user/appdata/omnilux

2. Create Docker Compose file

Create /mnt/user/appdata/omnilux/docker-compose.yml:

services:
  omnilux:
    image: ghcr.io/omnilux-tv/omnilux:latest
    container_name: omnilux
    restart: unless-stopped
    cap_add:
      - NET_ADMIN
    sysctls:
      - net.ipv4.conf.all.src_valid_mark=1
    ports:
      - "4000:4000"
      - "6881:6881/tcp"
      - "6881:6881/udp"
      - "1900:1900/udp"
    environment:
      NODE_ENV: production
      PORT: 4000
      OMNILUX_LIBRARY_ROOT: /data
      OMNILUX_DB_PATH: /app/data/omnilux.db
      OMNILUX_DOWNLOAD_PATH: /app/data/downloads
    volumes:
      - /mnt/user/appdata/omnilux:/app/data
      - /mnt/user/media:/data

3. Start

cd /mnt/user/appdata/omnilux
docker compose up -d

Unraid-specific path mappings

Container path	Unraid path	Purpose
/app/data	/mnt/user/appdata/omnilux	App data, database, downloads
/data	/mnt/user/media	Media library root
/data/movies	/mnt/user/media/movies	Movies (if separate shares)
/data/tv	/mnt/user/media/tv	TV shows
/data/music	/mnt/user/media/music	Music

GPU passthrough

NVIDIA

1. Install the Nvidia-Driver plugin from Community Applications
2. Add to your compose service:

omnilux:
  runtime: nvidia
  environment:
    NVIDIA_VISIBLE_DEVICES: all
    NVIDIA_DRIVER_CAPABILITIES: compute,video,utility

Intel Quick Sync

omnilux:
  devices:
    - /dev/dri:/dev/dri

Updating

cd /mnt/user/appdata/omnilux
docker compose pull
docker compose up -d

Access

Navigate to http://your-unraid-ip:4000.

TIP

Add OmniLux to your Unraid dashboard by going to the Docker tab and pinning the container.