OmniArr

React + TypeScript frontend with a built-in Node backend for:

• master-password login with HttpOnly session cookie
• encrypted storage of service settings
• Jellyfin, Sonarr, Radarr, qBittorrent and TMDb integration
• a single production process for Docker/TrueNAS

Persistence

All critical state is persisted under OMNIARR_DATA_DIR.

By default inside the container that is:

/app/data

The encrypted state file is:

/app/data/omniarr.secure.json

That file contains:

• master-password verifier
• encryption salt
• encrypted application settings

If you do not persist /app/data, you will lose:

• the master password
• all integration settings
• all saved configuration after restart, redeploy or image update

Local Development

Single command:

npm run dev:all

That starts:

• Vite frontend
• Node API server

If you want them separately:

npm run dev:server
npm run dev

Production

Build and serve:

npm run serve

Or separately:

npm run build
npm run start

The production server serves both the static frontend and the API on the same port.

Docker

Build:

docker build -t omniarr .

Run with persistence:

docker run -d \
  --name omniarr \
  --restart unless-stopped \
  -p 8787:8787 \
  -e PORT=8787 \
  -e OMNIARR_DATA_DIR=/app/data \
  -e TMDB_BEARER_TOKEN=your_tmdb_bearer_token \
  -v /path/on/host/omniarr-data:/app/data \
  omniarr

Docker Compose

There is a ready docker-compose.yml.

Start it with:

docker compose up -d --build

The default compose file uses:

./data:/app/data

For TrueNAS, replace ./data with a persistent dataset path if you prefer bind mounts managed outside the app directory.

TrueNAS Notes

Recommended app/container settings:

• Container port: 8787
• Host port: your choice, commonly 8787
• Storage mount: persistent dataset -> /app/data
• Restart policy: unless-stopped

Recommended environment variables:

• PORT=8787
• OMNIARR_DATA_DIR=/app/data
• TMDB_BEARER_TOKEN=... if you want TMDb configured at deploy time

Example host dataset mount:

/path/to/omniarr-data -> /app/data

That dataset is the piece that must survive updates and image replacements.

First Boot

On first boot there is no default password.

You create the master password in the UI.

After that, OmniArr stores only the verifier and encrypted settings in /app/data/omniarr.secure.json.