Setup & Deployment
Get your Omnius streaming server running in minutes.
1. Download
Download the latest binary for your platform from GitHub Releases:
2. Run
Choose your preferred method to run Omnius:
Make it executable and run:
chmod +x omnius-linux-amd64
ADMIN_PASSWORD=your_secure_password \
./omnius-linux-amd64The server starts on port 8080 by default. Data is stored in ./data/
Run with Docker using the official container image:
docker run -d \
--name omnius \
-p 8080:8080 \
-e ADMIN_PASSWORD=your_secure_password \
-v omnius-data:/app/data \
ghcr.io/omniusrepos/omnius-server:latestData is persisted in the omnius-data volume.
Run with Podman — same syntax as Docker, no daemon required:
podman run -d \
--name omnius \
-p 8080:8080 \
-e ADMIN_PASSWORD=your_secure_password \
-v omnius-data:/app/data \
ghcr.io/omniusrepos/omnius-server:latestData is persisted in the omnius-data volume.
Create a docker-compose.yml for easier management:
services:
omnius:
image: ghcr.io/omniusrepos/omnius-server:latest
ports:
- "8080:8080"
environment:
- ADMIN_PASSWORD=your_secure_password
volumes:
- omnius-data:/app/data
restart: unless-stopped
volumes:
omnius-data:Run with: docker compose up -d
3. Environment Variables
Configure your server with these environment variables:
| Variable | Default | Description |
|---|---|---|
| ADMIN_PASSWORD | admin | Password for the admin panel at /admin |
| PORT | 8080 | HTTP port |
| DATABASE_PATH | ./data/omnius.db | Path to SQLite database |
4. Try the Demo
Want to explore the admin panel before deploying your own instance?
We have a live demo instance so you can see how the admin panel works:
Visit Demo Instance→5. After Setup
Access the Admin Panel
Navigate to http://your-server:8080/admin and login with your ADMIN_PASSWORD.
Add Content
Use the admin panel to add movies, series, and curated lists to your server.
Configure Client Apps
Point your Android TV or macOS client apps to your server URL (e.g., http://your-server:8080).