# Odysseus-AIO

Odysseus-AIO is a self-hosted ai app. Self-hosted AI workspace — master container that auto-deploys the full stack (Odysseus, ChromaDB, SearXNG, ntfy). It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1633/odysseus-aio

## Description

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

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

48/100 (Fair), based on 3 of 4 factors.
- Maintained: 73 (last commit 116 days ago)
- Popular: 19 (8 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/realitymolder/odysseus-aio
- GitHub: https://github.com/realitymolder/odysseus-aio
- Unraid: https://ca.unraid.net/apps/odysseus-aio-1u442w70n1j5bv?q=Odysseus-AIO

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1633/odysseus-aio), the self-hosted and open-source app directory.
