FreeLLMAPI
ghcr.io/unraid-apps/freellmapi:latest
https://github.com/unraid-apps/freellmapi/pkgs/container/freellmapi
bridge
sh
false
https://github.com/unraid-apps/freellmapi/issues
https://github.com/tashfeenahmed/freellmapi
FreeLLMAPI aggregates the free tiers of 30+ LLM providers (Google, Groq, Cerebras, Mistral, OpenRouter, Cloudflare, NVIDIA, HuggingFace and more) behind one OpenAI-compatible /v1 endpoint, plus Anthropic Messages, Gemini and Ollama compatible APIs. A router picks the best available model, fails over on rate limits, rotates keys and tracks per-key usage so you stay inside every free-tier cap. Works with Claude Code, Codex CLI, Cursor, Cline, OpenCode, Aider, Open WebUI and any OpenAI-compatible client.
This image is the official upstream image plus a small entrypoint that generates the required ENCRYPTION_KEY on first start, so no terminal step is needed. The key is stored in your appdata folder as .encryption-key - back it up together with the database. Builds track upstream stable releases automatically; update through Unraid's Docker tab as usual.
FIRST START: open the WebUI. Because you reach it from another device, FreeLLMAPI asks for a one-time setup code printed in the container log (Docker tab, container icon, Logs). Then create the admin account, add provider keys on the Keys page and copy the unified freellmapi-... key for your clients. API base URL: http://[IP]:[PORT:3001]/v1
SECURITY: single-user application guarded only by its API key. Keep it on your LAN or behind Tailscale (fields are pre-filled, just enable "Use Tailscale"). Do not port-forward it to the internet.
Further tuning variables are documented in the upstream .env.example and can be added with "Add another Path, Port, Variable".
AI: Tools:Utilities Network:Web
http://[IP]:[PORT:3001]/
https://raw.githubusercontent.com/unraid-apps/freellmapi/main/templates/freellmapi.xml
https://raw.githubusercontent.com/unraid-apps/freellmapi/main/freellmapi-icon.png
--add-host=host.docker.internal:host-gateway --hostname=freellmapi
false
freellmapi
false
false
true
false
serve
3001
https://[hostname][magicdns]/
3001
/mnt/user/appdata/freellmapi
Europe/Berlin
off
120
90
100000