PodWarden Hub

PodWarden Hub extends your PodWarden instances with a centralized workload catalog, one-click Docker installer, DDNS subdomain management, MCP proxy for AI-powered infrastructure management, and a management portal.

Services

Features

One-Click Docker Installer

Every template in the catalog includes a Self-host with Docker button. Click it to get a one-line install command that downloads a bundle (docker-compose.yml, .env, config files), auto-generates passwords and secret keys, and starts the application. No PodWarden instance required — just Docker and Docker Compose on any Linux server. See Stack Templates for details.

MCP Proxy

Connect your AI assistant (Claude, Cursor, etc.) to Hub's MCP endpoint. Hub routes tool calls to your PodWarden instance through a secure WebSocket tunnel — no need to expose your instance to the internet. Configure Hub in Settings → Hub, enable the tunnel in Settings → MCP, then point your AI client at Hub using a Hub API key (pwc_). See the Hub MCP Proxy guide for setup instructions.

DDNS Subdomains

Get a public URL for your homelab in seconds. Hub manages DNS domains (e.g. vxloc.com, ichinichi.ai) and allocates subdomains like swift17.vxloc.com to your PodWarden instance. Your instance detects IP changes and pushes updates to Hub, which updates the Cloudflare A record automatically.

Free tier includes 1 subdomain. Pro gets 50 with custom slugs. Business and Enterprise get unlimited subdomains with bring-your-own-domain support. See Hub DDNS Subdomains for the full guide.

Workload Catalog

Browse curated stack templates organized by category: AI/ML, databases, monitoring, web servers, development tools, and more. Each template includes tested resource configurations, environment schemas, volume mounts, port mappings, network requirements, and documentation.

The catalog is organized as Applications containing one or more Stacks. An Application (e.g., "Redmine") is the top-level entry. Each Application has deployment options called Stacks — typically a Single Service (one container) and optionally a Compose Stack (multi-service docker-compose template). See Stack Templates for details.

GPU-Aware Templates

Templates for GPU workloads include VRAM requirements, tested GPU models, and optimized resource configurations. PodWarden can match templates to available GPU resources in your fleet.

Private Catalogs

Organizations on Business or Enterprise plans can access private template categories. Admins grant per-organization access to specific private categories via the catalog access system.

Private categories are invisible to organizations without an explicit access grant. This enables vendor-specific or internal template distribution — only authorized organizations see the templates.

Template Import & Updates

PodWarden instances connect to Hub via API key and can:

• Browse the catalog with search, category filtering, and tag filtering
• Import templates as local stacks (one click)
• Check for updates to previously imported templates

Anyone with Docker can:

• Self-host any catalog template using the one-click installer — no PodWarden instance needed

Imported templates track their Hub origin (hub_template_slug, hub_template_version, hub_imported_at) so you can check for newer versions.

Organizations & API Keys

Each account belongs to an organization. API keys are scoped to your organization and control what templates your PodWarden instances can see:

• Public templates — visible to all API keys
• Org-owned templates — visible only to your org's API keys
• Private category templates — visible only if your org has an explicit access grant

Admin Portal

Hub admins (superadmin/admin role) have access to:

• Template management — Create, edit, delete templates with full field editing including environment variables, ports, volumes, and network requirements
• Category management — Create categories, mark as private, manage access grants
• User management — View all users, change roles (user/admin/superadmin)
• Organization management — Change org tiers and status, grant/revoke private catalog access
• API key oversight — View and revoke any API key

Subscription Tiers

All plans include unlimited servers. Pricing is per organization, not per server or seat.

See Subscriptions for full details.