Odysseus connects to any OpenAI-compatible endpoint. Providers are managed inside the app — you add a base URL and an optional API key through the Settings UI, and Odysseus probes the endpoint, discovers the available models, and starts serving them in every picker immediately. TheDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/pewdiepie-archdaemon/odysseus/llms.txt
Use this file to discover all available pages before exploring further.
.env file is only needed for deployment-level overrides and pre-seeding credentials before first boot; for day-to-day use, prefer adding providers in the app.
How to add a provider
Enter the base URL
Paste the OpenAI-compatible base URL for your provider (see the reference table below). Do not include
/chat/completions — Odysseus appends the correct path automatically.Add an API key (if required)
For cloud providers paste your API key. For local providers running on your own machine no key is needed.
Provider reference
| Provider | Base URL | API Key |
|---|---|---|
| Ollama (native install) | http://localhost:11434/v1 | None |
| Ollama (Docker — host machine) | http://host.docker.internal:11434/v1 | None |
| vLLM | http://localhost:8000/v1 | None (configurable port) |
| llama.cpp server | http://localhost:8080/v1 | None |
| LM Studio | http://localhost:1234/v1 | None |
| OpenAI | https://api.openai.com/v1 | OPENAI_API_KEY from platform.openai.com |
| OpenRouter | https://openrouter.ai/api/v1 | API key from openrouter.ai |
| GitHub Copilot | — | Handled via the separate Copilot integration flow |
Docker and Ollama on the host
When Odysseus runs inside Docker and Ollama runs on your host machine (the most common setup on Windows and macOS), the correct endpoint URL is:host.docker.internal is Docker’s built-in hostname that resolves to the host from inside any container.
host.docker.internal is only available inside Docker. For native installs use http://localhost:11434/v1 as usual.LM Studio in Docker
LM Studio must be configured to serve on all interfaces (not justlocalhost) before Odysseus can reach it from inside Docker. In LM Studio’s server settings, change the bind address to 0.0.0.0, then use:
Model discovery
Odysseus scans common local model-server ports automatically, including Ollama’s11434 and vLLM/llama.cpp defaults in the 8000–8020 range. To point it at additional hosts (remote servers, Tailscale peers, etc.) set LLM_HOSTS in .env:
LLM_HOST alongside any extra hosts you list.
Pre-seeding with .env
You can pre-seed the OpenAI API key in.env so it is available before first boot. This is useful for automated or container deployments:
Custom CA certificates (LLM_CA_BUNDLE)
If your provider uses a TLS certificate that is not in the default system trust store — for example, an on-premise LLM gateway with an internal corporate CA, or GigaChat which uses a Russian Trusted Root CA — setLLM_CA_BUNDLE to a PEM file containing the missing root certificate(s):
CERTIFICATE_VERIFY_FAILED.