Odysseus-AIO

Docker app from RealityMolder's Repository

Overview

Self-hosted AI workspace — master container that auto-deploys the full stack (Odysseus, ChromaDB, SearXNG, ntfy). One install, full environment.

Readme

View on GitHub

This 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>:9000 for 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

MIT

Related apps

Explore more like this

Explore all

Tools apps

Links

Projectgithub.com Supportgithub.com Docker Hubregistry.hub.docker.com Templateraw.githubusercontent.com

Details

Repository

realitymolder/odysseus-aio:latest

Registry

https://registry.hub.docker.com

Last Updated2026-09-26

First Seen2026-06-25

Runtime arguments

Web UI: http://[IP]:[PORT:9000]
Network: bridge
Shell: bash
Privileged: false

Template configuration

Management PortPorttcp

AIO management web UI port

Target: 9000
Default: 9000
Value: 9000

AIO DataPathrw

AIO master container persistent state

Target: /data
Default: /mnt/user/appdata/odysseus-aio/data
Value: /mnt/user/appdata/odysseus-aio/data

Docker SocketPathrw

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

App DataVariable

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

App SSH KeysVariable

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

ChromaDB DataVariable

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

App ImageVariable

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

App PortVariable

Host port for the Odysseus web UI

Target: ODYSSEUS_APP_PORT
Default: 7000
Value: 7000

ChromaDB PortVariable

Host port for ChromaDB

Target: ODYSSEUS_CHROMADB_PORT
Default: 8100
Value: 8100

SearXNG PortVariable

Host port for SearXNG

Target: ODYSSEUS_SEARXNG_PORT
Default: 8080
Value: 8080

ntfy PortVariable

Host port for ntfy

Target: ODYSSEUS_NTFY_PORT
Default: 8091
Value: 8091

App Container PortVariable

Internal port Odysseus listens on (change only if using a custom image)

Target: ODYSSEUS_APP_CONTAINER_PORT
Default: 7000
Value: 7000

ChromaDB Container PortVariable

Internal port ChromaDB listens on

Target: ODYSSEUS_CHROMADB_CONTAINER_PORT
Default: 8000
Value: 8000

SearXNG Container PortVariable

Internal port SearXNG listens on

Target: ODYSSEUS_SEARXNG_CONTAINER_PORT
Default: 8080
Value: 8080

ntfy Container PortVariable

Internal port ntfy listens on

Target: ODYSSEUS_NTFY_CONTAINER_PORT
Default: 80
Value: 80

PUIDVariable

User ID for file permissions

Target: ODYSSEUS_PUID
Default: 99
Value: 99

PGIDVariable

Group ID for file permissions

Target: ODYSSEUS_PGID
Default: 100
Value: 100

Auth EnabledVariable

Enable authentication

Target: ODYSSEUS_AUTH_ENABLED
Default: true
Value: true

Admin UserVariable

First admin account username

Target: ODYSSEUS_ADMIN_USER
Default: admin
Value: admin

Admin PasswordVariable

Pre-seed admin password (leave blank for auto-generated)

Target: ODYSSEUS_ADMIN_PASSWORD

DNS ServersVariable

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

NVIDIA GPUVariable

Enable NVIDIA GPU passthrough for the Odysseus app container (requires NVIDIA Container Toolkit)

Target: ODYSSEUS_NVIDIA_ENABLED
Default: false
Value: false

LLM HostVariable

Primary LLM server hostname or IP

Target: ODYSSEUS_LLM_HOST

OpenAI API KeyVariable

OpenAI API key

Target: ODYSSEUS_OPENAI_API_KEY

Ollama URLVariable

Ollama server URL (e.g. http://host.docker.internal:11434)

Target: ODYSSEUS_OLLAMA_BASE_URL

HF TokenVariable

HuggingFace token for gated models

Target: ODYSSEUS_HF_TOKEN

SearXNG SecretVariable

SearXNG secret key (auto-generated if empty)

Target: ODYSSEUS_SEARXNG_SECRET

ntfy Base URLVariable

Public ntfy URL for push notifications

Target: ODYSSEUS_NTFY_BASE_URL

Brave API KeyVariable

Brave Search API key

Target: ODYSSEUS_DATA_BRAVE_API_KEY

Google API KeyVariable

Google Custom Search API key

Target: ODYSSEUS_GOOGLE_API_KEY

Tavily API KeyVariable

Tavily Search API key

Target: ODYSSEUS_TAVILY_API_KEY

Serper API KeyVariable

Serper API key

Target: ODYSSEUS_SERPER_API_KEY

Library

Curated

Categories