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.
Power your agent
Cài đặt từ nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
Chưa có bản phát hành đóng gói nào trong registry. Làm theo README của kho mã.
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên 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.
MởTừ nhà phát hành
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.
Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
Vauxtra chạy cục bộ qua stdio.
Kiểm tra lần cuối: 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.