Self-host voidllm
v0.0.30LLM proxy and AI gateway with zero-knowledge privacy
- Stars
- 145
- Port
- 8080 (OpenAI-compatible proxy API and admin UI)
ghcr.io/voidmind-io/voidllmWhat is voidllm?
VoidLLM runs on your own infrastructure as a gateway for LLM traffic. Applications send OpenAI-compatible requests to it, and it forwards them to whichever provider you configure — managed services like OpenAI or Anthropic, or self-hosted options such as Ollama and vLLM. You define short model names that clients use, while the proxy decides where each request actually goes. Four load-balancing methods spread traffic across multiple deployments and automatically retry on failures. Permissions follow a four-tier hierarchy with four roles, and quotas for requests and tokens are enforced at every tier with the tightest limit taking effect. A web console gives you a dashboard, a playground for testing, key administration, and usage reports. An MCP gateway includes six built-in tools and can also forward calls to external MCP servers with per-organization or per-team access rules. Code Mode allows agents to execute sandboxed JavaScript that chains several tool calls together. Metrics are available in Prometheus format. The program is a single Go binary of roughly 25 megabytes; it uses SQLite by default and can switch to PostgreSQL. Installation options include Docker, Docker Compose, Helm, pre-built binaries for major platforms, and a one-click Railway button. Prompts and responses are never persisted — only metadata like token counts and latency is stored. The license is BSL 1.1, which becomes Apache 2.0 after four years. The free tier has all core features; paid tiers add unlimited organizations, cost reporting, SSO, audit logs, distributed tracing, and multi-instance support.
Should you self-host voidllm?
voidllm scores 43/100 on selfhost.directory (how scoring works) and ranks #26 of 39 in API Gateway. It has 145 GitHub stars.
It shipped 18 stable releases in the past year. The latest, v0.0.30, came out on 30 September 2026.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Go.
Its closest alternative on selfhost.directory is OmniRoute (88/100, 82 107 stars). It scores higher overall, so compare the two before you pick. See voidllm vs OmniRoute side by side.
Features
- Automatic Failover
- Code Mode
- Load Balancing
- MCP Gateway
- Model aliases
- Multi-provider routing
- OpenAI-compatible proxy
- Prometheus Metrics
- Rate Limiting
- RBAC
- SSO/OIDCEnterprise tier only
- Token budgets
- Usage Tracking
- Web UI
- Zero-knowledge architecture
voidllm README
FAQ
What is BSL 1.1?
Business Source License. Source available, free to self-host for any purpose including commercial use. Cannot sell as a hosted LLM proxy service. Converts to Apache 2.0 after 4 years.
What does Enterprise add?
Everything in Pro plus SSO/OIDC (any provider), audit logs, OpenTelemetry tracing, and multi-instance support with Redis for €149/mo or €1,490/yr.
What does Pro add?
Unlimited organizations and teams, cost reports with model breakdown, cross-org analytics, and priority email support for €49/mo or €490/yr.
Is VoidLLM free?
The Community tier is free with no time limit. It includes load balancing, MCP gateway, RBAC, rate limiting, circuit breakers, and the full admin UI.
Does VoidLLM support MCP?
Yes. A built-in MCP server exposes 6 management tools and a gateway for external MCP servers with scoped access control per org and team.
Can I use self-hosted models?
Yes. vLLM, Ollama, or any OpenAI-compatible endpoint works. Point VoidLLM at your local or on-prem deployment.
What is Code Mode?
AI agents write JavaScript to orchestrate multiple MCP tool calls in a single WASM-sandboxed execution, reducing token usage and round-trips.
Does VoidLLM support load balancing?
Yes. Four strategies: round-robin, least-latency, weighted, and priority. Automatic failover with circuit breakers included in the free tier.
What is the proxy overhead?
Under 500 microseconds at 2000 RPS. In-memory auth lookup and async usage logging keep the hot path lean.
How does VoidLLM handle GDPR?
The zero-knowledge architecture means no personal data from prompts is processed or stored. Only metadata is tracked, significantly reducing compliance surface area.
Does VoidLLM log my prompts?
No. There is no content logging code to enable. Prompts and responses pass through memory only and are never written to disk, logs, or the database.
Do I need PostgreSQL?
No. SQLite is the default and works well for most deployments. PostgreSQL is optional and recommended only for multi-instance setups with shared state.
Can I use VoidLLM with Claude Code or Cursor?
Yes. Cursor and Windsurf work as a standard LLM proxy by changing the base URL. Claude Code connects via the built-in MCP server.
Which LLM providers does VoidLLM support?
OpenAI, Anthropic, Azure OpenAI, Ollama, vLLM, and any OpenAI-compatible endpoint.
How do I install VoidLLM?
VoidLLM can be installed via Docker one-liner, single binary download, or Helm chart. The Getting Started guide provides a step-by-step walkthrough.
More in API Gateway
WA-AKGWA-AKG is a self-hosted, open-source WhatsApp gateway with dashboard for managing sessions, scheduling messages, auto-replies, and REST API integration.
WaxumSelf-hosted WhatsApp gateway in Rust with 230+ endpoints for messaging, calls, groups, and webhooks.
Weave RouterOpen-source LLM model router for coding agents like Claude Code, Codex, and Cursor; self-hosted with Docker Compose, it picks the cheapest capable model per request.
wundergraphOpen-source, self-hosted lifecycle manager for federated GraphQL APIs: schema registry, breaking-change checks, router, usage analytics and tracing.
1flowbaseAn open-source AI Gateway and app runtime you host yourself, unifying model access with PostgreSQL storage, workflows, APIs, and React apps via MCP.
9RouterOpen-source, self-hosted AI router giving coding CLIs one OpenAI-compatible endpoint, 3-tier fallback across 60+ providers, token compression and a local dashboard.
agentgatewayOpen-source, self-hosted HTTP and gRPC gateway routing LLM, MCP, A2A and service traffic in one binary, with auth, policy, guardrails, cost controls and observability.
AgentSafeSelf-hosted gateway intercepting AI agent HTTP actions, asking Decionis for authorization, forwarding only approved requests with signed evidence.
ai-apiSelf-hosted AI gateway unifying Azure OpenAI, OpenAI, Anthropic, and Gemini behind one OpenAI-compatible API with revocable credentials and cost tracking.
Ailin¹ Collective IntelligenceSelf-hosted open-source engine coordinating 100,000+ AI models through 31 strategies with verifiable consensus and OpenAI-compatible API.
AISIX OSSSelf-hosted, open-source AI gateway with one OpenAI-compatible API for 100+ LLM providers, routing, guardrails, caching, rate limits, and observability — built in Rust.
anythingmcpSelf-hosted gateway turning APIs and databases into MCP tools for AI assistants, with hundreds of ready connectors and access controls.




0 comments