All apps · 0 apps
Odysseus-AIO
Docker app from RealityMolder-Odysseus' Repository
Overview
Readme
View on GitHubThis repo has been changed to only include AIO program/image. if you are looking for unraid templates go to: https://github.com/realitymolder/ca-templates
Odysseus AIO
All-in-one master container for Odysseus self-hosted AI workspace. One install deploys the full stack: Odysseus, ChromaDB, SearXNG, and ntfy.
What it does
On first start, the AIO container automatically pulls and provisions:
| Container | Image | Port |
|---|---|---|
odysseus-aio-app |
realitymolder/odysseus:stable |
7000 |
odysseus-aio-chromadb |
chromadb/chroma:latest |
8100 |
odysseus-aio-searxng |
searxng/searxng:latest |
8080 |
odysseus-aio-ntfy |
binwiederhier/ntfy |
8091 |
A built-in management UI at port 9000 handles deploy, stop, update, and status monitoring.
Image
docker.io/realitymolder/odysseus-aio:latest
Quick start
Unraid (CA template)
- Add this repo to CA: Apps → Settings → Template Repositories →
https://github.com/realitymolder/odysseus-aio - Install Odysseus-AIO
- Open
http://<your-ip>:9000for the management UI
Docker Compose
docker compose -f docker-compose.aio.yml up -d
Configuration
Choosing stable vs dev
The AIO pulls the upstream Odysseus image based on the ODYSSEUS_APP_IMAGE environment variable:
| Value | Description |
|---|---|
realitymolder/odysseus:stable |
Latest stable release (default) |
realitymolder/odysseus:dev |
Latest development build |
realitymolder/odysseus:YYYY-MM-DD |
Pin to a specific date |
Set it in the Unraid template or in docker-compose.aio.yml.
Environment variables
| Variable | Default | Description |
|---|---|---|
ODYSSEUS_APP_IMAGE |
realitymolder/odysseus:stable |
Upstream Odysseus image to deploy |
ODYSSEUS_APP_PORT |
7000 |
Host port for Odysseus web UI |
ODYSSEUS_CHROMADB_PORT |
8100 |
Host port for ChromaDB |
ODYSSEUS_SEARXNG_PORT |
8080 |
Host port for SearXNG |
ODYSSEUS_NTFY_PORT |
8091 |
Host port for ntfy |
ODYSSEUS_PUID |
99 |
User ID for file permissions |
ODYSSEUS_PGID |
100 |
Group ID for file permissions |
ODYSSEUS_AUTH_ENABLED |
true |
Enable authentication |
ODYSSEUS_ADMIN_USER |
admin |
Admin username |
ODYSSEUS_ADMIN_PASSWORD |
(auto-generated) | Pre-seed admin password |
ODYSSEUS_LLM_HOST |
Primary LLM server hostname | |
ODYSSEUS_OPENAI_API_KEY |
OpenAI API key | |
ODYSSEUS_OLLAMA_BASE_URL |
Ollama server URL | |
ODYSSEUS_NVIDIA_ENABLED |
false |
Enable NVIDIA GPU passthrough |
ODYSSEUS_DNS_SERVERS |
8.8.8.8,1.1.1.1 |
DNS for managed containers |
Requirements
- Docker socket access (
/var/run/docker.sock) for managing sibling containers - For GPU: NVIDIA Container Toolkit
Related repos
| Repo | Purpose |
|---|---|
| odysseus | Main Odysseus Docker image (stable + dev builds) |
| odysseus-ca-templates | Unraid CA templates for standalone install |
License
Install Odysseus-AIO on Unraid in a few clicks.
Find Odysseus-AIO in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.
Categories
Download Statistics
Related apps
Explore more like this
Explore allLinks
Details
realitymolder/odysseus-aio:latestRuntime arguments
- Web UI
http://[IP]:[PORT:9000]- Network
bridge- Shell
bash- Privileged
- false
Template configuration
AIO management web UI port
- Target
- 9000
- Default
- 9000
- Value
- 9000
AIO master container persistent state
- Target
- /data
- Default
- /mnt/user/appdata/odysseus-aio/data
- Value
- /mnt/user/appdata/odysseus-aio/data
Required for managing sibling containers. Must map to host /var/run/docker.sock
- Target
- /var/run/docker.sock
- Default
- /var/run/docker.sock
- Value
- /var/run/docker.sock
Host path for app data (DB, uploads, user data). Leave blank for Docker volume.
- Target
- ODYSSEUS_APP_DATA
- Default
- /mnt/user/appdata/odysseus-aio/data
- Value
- /mnt/user/appdata/odysseus-aio/data
Host path for SSH keys (Cookbook remote servers). Leave blank for Docker volume.
- Target
- ODYSSEUS_APP_SSH
- Default
- /mnt/user/appdata/odysseus-aio/ssh
- Value
- /mnt/user/appdata/odysseus-aio/ssh
Host path for ChromaDB vector index data. Leave blank for Docker volume.
- Target
- ODYSSEUS_CHROMADB_DATA
- Default
- /mnt/user/appdata/odysseus-aio/chromadb
- Value
- /mnt/user/appdata/odysseus-aio/chromadb
Docker image for the Odysseus app container. Use 'stable' for production or 'dev' for latest development builds.
- Target
- ODYSSEUS_APP_IMAGE
- Default
- realitymolder/odysseus:stable
- Value
- realitymolder/odysseus:stable
Host port for the Odysseus web UI
- Target
- ODYSSEUS_APP_PORT
- Default
- 7000
- Value
- 7000
Host port for ChromaDB
- Target
- ODYSSEUS_CHROMADB_PORT
- Default
- 8100
- Value
- 8100
Host port for SearXNG
- Target
- ODYSSEUS_SEARXNG_PORT
- Default
- 8080
- Value
- 8080
Host port for ntfy
- Target
- ODYSSEUS_NTFY_PORT
- Default
- 8091
- Value
- 8091
Internal port Odysseus listens on (change only if using a custom image)
- Target
- ODYSSEUS_APP_CONTAINER_PORT
- Default
- 7000
- Value
- 7000
Internal port ChromaDB listens on
- Target
- ODYSSEUS_CHROMADB_CONTAINER_PORT
- Default
- 8000
- Value
- 8000
Internal port SearXNG listens on
- Target
- ODYSSEUS_SEARXNG_CONTAINER_PORT
- Default
- 8080
- Value
- 8080
Internal port ntfy listens on
- Target
- ODYSSEUS_NTFY_CONTAINER_PORT
- Default
- 80
- Value
- 80
User ID for file permissions
- Target
- ODYSSEUS_PUID
- Default
- 99
- Value
- 99
Group ID for file permissions
- Target
- ODYSSEUS_PGID
- Default
- 100
- Value
- 100
Enable authentication
- Target
- ODYSSEUS_AUTH_ENABLED
- Default
- true
- Value
- true
First admin account username
- Target
- ODYSSEUS_ADMIN_USER
- Default
- admin
- Value
- admin
Pre-seed admin password (leave blank for auto-generated)
- Target
- ODYSSEUS_ADMIN_PASSWORD
DNS servers for managed containers (comma-separated)
- Target
- ODYSSEUS_DNS_SERVERS
- Default
- 8.8.8.8,1.1.1.1
- Value
- 8.8.8.8,1.1.1.1
Enable NVIDIA GPU passthrough for the Odysseus app container (requires NVIDIA Container Toolkit)
- Target
- ODYSSEUS_NVIDIA_ENABLED
- Default
- false
- Value
- false
Primary LLM server hostname or IP
- Target
- ODYSSEUS_LLM_HOST
OpenAI API key
- Target
- ODYSSEUS_OPENAI_API_KEY
Ollama server URL (e.g. http://host.docker.internal:11434)
- Target
- ODYSSEUS_OLLAMA_BASE_URL
HuggingFace token for gated models
- Target
- ODYSSEUS_HF_TOKEN
SearXNG secret key (auto-generated if empty)
- Target
- ODYSSEUS_SEARXNG_SECRET
Public ntfy URL for push notifications
- Target
- ODYSSEUS_NTFY_BASE_URL
Brave Search API key
- Target
- ODYSSEUS_DATA_BRAVE_API_KEY
Google Custom Search API key
- Target
- ODYSSEUS_GOOGLE_API_KEY
Tavily Search API key
- Target
- ODYSSEUS_TAVILY_API_KEY
Serper API key
- Target
- ODYSSEUS_SERPER_API_KEY