Self-hosted DNS & reverse proxy management panel — built for homelab. Orchestrate Nginx Proxy Manager, Traefik, Zoraxy, Cloudflare, Pi-hole, AdGuard Home, and more from one unified interface.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
Self-hosted DNS & reverse proxy management panel — built for homelab. Orchestrate Nginx Proxy Manager, Traefik, Zoraxy, Cloudflare, Pi-hole, AdGuard Home, and more from one unified interface.
Self-hosted DNS and reverse proxy management panel for homelabs. Orchestrate Nginx Proxy Manager, Traefik, Zoraxy, Cloudflare, Pi-hole and AdGuard Home from one interface.
Quick Start · Features · Screenshots · Providers · Docs · MCP
Publishing a new self-hosted app usually means touching three tools: a DNS record in Cloudflare or Pi-hole, a proxy host in Nginx Proxy Manager or Traefik, maybe a Cloudflare Tunnel route — and then remembering to keep them in sync. Vauxtra turns that into one service record: pick a hostname, a target and the providers that should publish it, and Vauxtra pushes, monitors and reconciles every piece for you.
Screenshots follow your GitHub theme: switch between light and dark mode to see both UI themes.
┌─────────────────────────────────────────────────────────┐
│ Vauxtra │
│ │
│ React 19 + TypeScript + Vite (SPA) │
│ │ │
│ FastAPI + SQLite (WAL) │
│ │ │
│ ┌──────┴────────────────────────┐ │
│ │ Providers │ │
│ │ NPM Zoraxy Traefik │ │
│ │ Cloudflare DNS CF Tunnel │ │
│ │ Pi-hole AdGuard Technitium │ │
│ │ PowerDNS deSEC │ │
│ └───────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
│
MCP Server (FastMCP) — client and automation integration
Vauxtra is an orchestrator: it does not run a reverse proxy or DNS server itself — it configures the ones you already have running.
Pull the pre-built image from GitHub Container Registry:
docker run -d \
--name vauxtra \
-p 127.0.0.1:8888:8888 \
-v vauxtra_data:/app/data \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
ghcr.io/ptitzgeg-on-git/vauxtra:latest
The port is published on the loopback: the panel holds provider credentials and has none of its own until you complete the setup wizard. Once you have,
-p 8888:8888reaches it from the LAN — behind a reverse proxy, preferably.
The Docker socket is only needed for container discovery, and mounting it is a real grant:
:roapplies to the socket file, not to the Docker API, so whoever reaches it can start a privileged container and is root on the host. Drop the-v /var/run/docker.sockline if you do not use the Docker features — the rest of Vauxtra is unaffected and the Docker screens answer "daemon unavailable" — or front it with a read-only socket proxy.
Or use Docker Compose:
# docker-compose.yml
services:
vauxtra:
image: ghcr.io/ptitzgeg-on-git/vauxtra:latest
ports:
# Loopback by default; VAUXTRA_BIND=0.0.0.0 publishes on every interface.
- "${VAUXTRA_BIND:-127.0.0.1}:8888:8888"
volumes:
- ./data:/app/data
- /var/run/docker.sock:/var/run/docker.sock:ro
environment:
- TZ=${TZ:-UTC}
restart: unless-stopped
docker compose up -d
Then open http://localhost:8888 in your browser.
The data/ directory stores the SQLite database and the auto-generated secret key.
Build from source? Clone the repo and run
docker compose up --build -d.
All configuration is via environment variables. Copy .env.example to .env and fill in your values.
⚠️ Important: Do not change
SECRET_KEYafter adding providers. All stored credentials are encrypted with this key.
Forgot your password? If set via
.env, edit the file. If set via the Setup wizard, use Settings → Security → Change Password while logged in. Locked out entirely, clear both rows and restart:sqlite3 data/vauxtra.db "DELETE FROM settings WHERE key IN ('app_password_hash','auth_mode');"
auth_modeis what tells a deliberately passwordless install apart from one whose hash went missing. Deleting the hash on its own leaves the second state, and Vauxtra then refuses every request rather than falling back to anonymous admin — which is the point of it, and why it has to go too.
npm, URL = http://your-npm:81.Traefik is read-only in Vauxtra (it configures itself via Docker labels or config files).
http://traefik:8080.traefik, URL = http://traefik:8080.Zoraxy has a single admin account and no API keys: Vauxtra logs in with the same credentials you use in the browser. Keep the management port reachable from the LAN or VPN only.
http://zoraxy:8000, and the admin username/password
(leave both empty for an instance started with -noauth).zoraxy, URL = http://zoraxy:8000.Vauxtra manages host rules only (no virtual directories, no TCP/UDP stream proxies) and one upstream per rule; extra load-balanced upstreams are left untouched. Zoraxy terminates TLS globally, so there is no per-host "force SSL" switch.
cloudflare, API token = <your-token>.Account -> Cloudflare Tunnel -> EditZone -> DNS -> Editcloudflare_tunnel, with Account ID, API token, and Tunnel ID.http://pihole or http://localhost:18081), not /admin.pdns.conf: api=yes, api-key=<key>, webserver=yes, and a
webserver-allow-from that includes Vauxtra. The API listens on :8081 by default.powerdns, URL = http://your-pdns:8081,
server id = localhost (the stock value), API key = <key>.desec, token = <token>. Leave the URL empty
unless you run your own deSEC instance.Vauxtra ships an MCP (Model Context Protocol) server package that exposes core operations as tools. Connect it to any MCP-compatible client.
The MCP server runs on the host (next to your MCP client), not inside the Vauxtra Docker image. Clone this repo and
pip install -r vauxtra_mcp/requirements.txton the machine that will launch the client. The server reaches Vauxtra over HTTP usingVAUXTRA_URL+VAUXTRA_API_KEY.
Add an equivalent server block to your MCP client configuration:
{
"mcpServers": {
"vauxtra": {
"command": "python",
"args": ["-m", "vauxtra_mcp.server"],
"cwd": "/path/to/vauxtra",
"env": {
"VAUXTRA_URL": "http://localhost:8888",
"VAUXTRA_API_KEY": "vx_your_key_here"
}
}
}
}
See docs/HOWTO.md for the full list. Summary:
Services — list_services, get_service, create_service, update_service, set_service_labels, delete_service, toggle_service, sync_services_from_providers, import_services_from_sync
Templates — list_templates, get_template, create_template, delete_template, apply_template
Operations — run_preflight, dry_run_push, push_service, check_drift, reconcile_service
Providers — list_providers, get_provider_types, create_provider, update_provider, delete_provider, test_provider, get_provider_health, get_all_providers_health, get_tunnel_health
Docker — list_docker_endpoints, discover_docker_containers, import_docker_containers
Monitoring — get_health, get_logs, get_stats, get_certificates, get_certificate_expiry, check_all_services
When DEBUG=true is set, the full interactive API documentation is available at:
http://localhost:8888/api/docs
All endpoints accept Authorization: Bearer <api_key> in addition to session cookies.
# Requires Python 3.13+
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# Run with auto-reload
uvicorn app.main:app --reload --port 8888
cd frontend
npm install
npm run dev # Dev server on :5173 with API proxy to :8888
npm run build # Production build to frontend/dist/
npm run lint # ESLint
The frontend dev server (npm run dev) proxies /api/* to the FastAPI backend at :8888. Run both in separate terminals.
docker compose up --build
The Dockerfile uses a multi-stage build: Node 26 for the frontend, Python 3.14-slim for the final image.
See CONTRIBUTING.md for:
The UI is fully internationalized. To add or improve a translation:
frontend/src/locales/en.jsonko.json)SUPPORTED_LANGUAGES in frontend/src/i18n/index.tsxVauxtra follows a rolling release model on the latest Docker tag:
docker compose pull
docker compose up -d
The database is automatically migrated on startup. No manual steps required.
MIT — see LICENSE.
Self-hosted DNS and reverse proxy management panel for homelabs. Orchestrate Nginx Proxy Manager, Traefik, Zoraxy, Cloudflare, Pi-hole and AdGuard Home from one interface.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Vauxtra roda localmente via stdio.
Última verificação: 2026-10-28. Self-hosted DNS and reverse proxy management panel for homelabs. Orchestrate Nginx Proxy Manager, Traefik, Zoraxy, Cloudflare, Pi-hole and AdGuard Home from one interface.