Odysseus-AIO

Odysseus-AIO

Docker app from RealityMolder-Odysseus' Repository

Overview

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

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)

  1. Add this repo to CA: AppsSettingsTemplate Repositorieshttps://github.com/realitymolder/odysseus-aio
  2. Install Odysseus-AIO
  3. 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

Related repos

Repo Purpose
odysseus Main Odysseus Docker image (stable + dev builds)
odysseus-ca-templates Unraid CA templates for standalone install

License

MIT

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.

Open the Apps tab on your Unraid server Search Community Apps for Odysseus-AIO Review the template variables and paths Click Install

Categories

Download Statistics

1,124
Total Downloads

Related apps

Explore more like this

Explore all

Details

Repository
realitymolder/odysseus-aio:latest
Last Updated2026-06-25
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