ABOUT
OmniRoute is a self-hosted, OpenAI-compatible AI gateway that routes requests across 290+ providers and 500+ models with quota-aware auto-fallback, prompt compression and a management dashboard. Works with Claude Code, Cursor, Cline, Codex and any OpenAI-compatible client.
warningThe generated admin password and secrets (JWT_SECRET, API_KEY_SECRET, STORAGE_ENCRYPTION_KEY) are set once at install and stored in /opt/omniroute/.env. The dashboard login uses INITIAL_PASSWORD from that file.
warningSTORAGE_ENCRYPTION_KEY encrypts the SQLite database at rest. Do not lose /opt/omniroute/.env or the encrypted data becomes unrecoverable.
infoReset the admin password anytime with: omniroute-reset-password
INSTALL
Approved local installer
DefaultDebian 13
Approved locally2 CPU2048 MB RAM10 GB disk
Config path/opt/omniroute/.env
Run this command in the Proxmox VE shell. It downloads the immutable approved file, verifies SHA-256, and only then executes it.
( url='https://scripts.francoisvw.com/snapshots/c19711ea1b2526bec67e34be948114e255b5a811/ct/omniroute.sh'; sha='7ff189805a1c9916049e77fd084fa0f4cb7ffc161ff7f7bcdad44ebecb2e532e'; tmp="$(mktemp)" || exit; curl -fsSL "$url" -o "$tmp" && printf '%s %s\n' "$sha" "$tmp" | sha256sum -c - && bash "$tmp"; rc=$?; rm -f "$tmp"; exit "$rc" )
View approved source ↗Path ct/omniroute.shSHA-256 7ff189805a1c9916049e77fd084fa0f4cb7ffc161ff7f7bcdad44ebecb2e532e LOCAL CHANGE REVIEW
Approved vs latest fetched source
Sign in with a passkey to inspect pending source changes. Approved content remains public.