selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

voidllm logo

Self-host voidllm

v0.0.30

LLM proxy and AI gateway with zero-knowledge privacy

BetaSource AvailableOther
Updated10 hours ago
LanguageGo
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
145
Port
8080 (OpenAI-compatible proxy API and admin UI)
Docker
ghcr.io/voidmind-io/voidllm
Install with Docker
VoidLLM Dashboard showing request stats and model healthUsage Analytics page with token usage and cost trackingAPI Keys management pagePlayground for testing models in the browser

What is voidllm?

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

How to install voidllm

Install voidllm with Docker

Docker Engine
Environment variables
VOIDLLM_ADMIN_KEY, VOIDLLM_ENCRYPTION_KEY, VOIDLLM_DATABASE_DSN, VOIDLLM_DATABASE_DRIVER, VOIDLLM_LICENSE

docker run -p 8080:8080
-e VOIDLLM_ADMIN_KEY -e VOIDLLM_ENCRYPTION_KEY
-v voidllm_data:/data
ghcr.io/voidmind-io/voidllm:latest

Requires VOIDLLM_ADMIN_KEY and VOIDLLM_ENCRYPTION_KEY environment variables

voidllm releases & version history

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

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…