Odysseus-AIO
Self-hosted AI workspace — master container that auto-deploys the full stack (Odysseus, ChromaDB, SearXNG, ntfy).
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
48/100 Fair
- Maintained
- 73last commit 116 days ago
- Popular
- 198 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 39 days ago
- GitHub stars
- 8
- Open issues
- 2
- Last commit
- 2026-07-28
- Latest release
- stable-b053380
- License
- MIT
- Activity
- stale
Checked 10 days ago - source: GitHub (realitymolder/odysseus-aio)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Start with Docker and your .env file Copy `.env.example` to `.env`, fill in any settings it asks for, then run `docker compose up -d --build` to start everything in Docker. This matters because the app reads that `.env` file — a plain-text settings file — before starting, and Docker Compose avoids installing each piece by hand. source
- Add optional features after first run If you want local speech-to-text, text-to-speech, or document extraction, activate the same Python environment and run `pip install -r requirements-optional.txt`. Without this optional step, those extra features won’t be available, but the basic app can still run. source
- Expose Ollama if you use local models If Odysseus should use local models through Ollama, start Ollama on the host with `OLLAMA_HOST=0.0.0.0:11434 ollama serve` so Docker containers can reach it. If it only listens on localhost, Odysseus may not be able to connect, and local-model features can fail. source
- Management UI Access the built-in management UI at port 9000 to view and manage all deployed containers. source
Fetched 38 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Which ports should I expect from a fresh Odysseus-AIO install?
The management UI runs on port 9000. The deployed services default to 7000 for Odysseus, 8100 for ChromaDB, 8080 for SearXNG, and 8091 for ntfy.
Why does the container need Docker socket access?
It acts as a master container that pulls and provisions the Odysseus, ChromaDB, SearXNG, and ntfy containers. Docker socket access is required for that management role.
How do I set the admin username and password?
Authentication is enabled by default and the admin username defaults to admin. Set ODYSSEUS_ADMIN_PASSWORD to pre-seed the password; if it is left empty, a password is auto-generated.
How do I connect the workspace to an Ollama server?
Set ODYSSEUS_OLLAMA_BASE_URL to the Ollama server URL. You can also use ODYSSEUS_LLM_HOST for the primary LLM server hostname.
What do I need to enable NVIDIA GPU support?
Set ODYSSEUS_NVIDIA_ENABLED to true. The NVIDIA Container Toolkit must be installed for GPU support.
How do I update the deployed stack?
Open the built-in management UI on port 9000 and use its update function. The UI also handles deploy, stop, and status monitoring.
Answers sourced from github.com
Community
- Reddit (reddit)
- Whit's End - Reddit (reddit)
Collected 53 days ago - public community threads