Skip to main content
50% off all plans, limited time. Starting at $2.48/mo
OmniRoute

OmniRoute

OmniRoute is an AI gateway that puts hundreds of model providers behind one endpoint, with quota-aware fallback and token compression. Works with Claude Code, Codex, Cursor, Cline, and Copilot. MIT licensed with 50,700+ GitHub stars.

At a glance

License MIT Version Latest OS Ubuntu Server 24.04 LTS Min RAM 2 GB IP IPV4,IPV6

Access

  1. Open http://<SERVER_IP> in your browser.
  2. Use the initial password stored as INITIAL_PASSWORD in /root/omniroute/.env.
  3. Change the password from the dashboard after logging in.

Important Files & Directories

  • Install Path: /root/omniroute
  • Compose File: /root/omniroute/docker-compose.yml
  • Environment: /root/omniroute/.env
  • Caddyfile: /root/omniroute/Caddyfile
  • OmniRoute Data: /var/lib/docker/volumes/omniroute-data/_data
  • Redis Data: /var/lib/docker/volumes/redis-data/_data
  • Caddy Data: /var/lib/docker/volumes/caddy-data/_data
  • Caddy Config: /var/lib/docker/volumes/caddy-config/_data

Docker Management

View status:

docker ps

View logs:

cd /root/omniroute
docker compose logs -f

Restart services:

cd /root/omniroute
docker compose restart

Stop services:

cd /root/omniroute
docker compose down

Start services:

cd /root/omniroute
docker compose up -d

Domain & HTTPS (Caddy)

0. HTTPS certificates cannot be issued for IP addresses.

1. Point a domain (for example, omniroute.example.com) to your server's IP address.

2. Edit /root/omniroute/.env and update NEXT_PUBLIC_BASE_URL:

BASE_URL=https://omniroute.example.com

3. Update /root/omniroute/Caddyfile:

omniroute.example.com {
    reverse_proxy omniroute:20128
}

4. Recreate the services:

docker compose -f /root/omniroute/docker-compose.yml up -d

5. Caddy will automatically obtain and renew SSL certificates.

6. Access OmniRoute at omniroute.example.com.

More in Self Hosted

Related apps.

Deploy OmniRoute now. From $2.48/mo.