PodWarden
User ManualPodWarden

Settings: Hub

PodWarden Hub connection for template catalog and updates

PodWarden Hub settings page with Hub URL and API key fields
Hub settings — connect to PodWarden Hub for template catalog access

What you see

URL: /settings (Hub tab)

The Hub tab configures PodWarden's connection to PodWarden Hub -- the SaaS template catalog. When connected, you can browse and import stack templates directly from the Hub catalog into your local instance.

Fields

PodWarden Hub settings showing Hub URL, API Key, and Instance Name fields with placeholder text
The Hub settings card with the Instance Name field. Set a descriptive name so you can identify this PodWarden instance when connecting from Hub.
FieldDescription
Hub URLThe PodWarden Hub API endpoint (default: https://apps.podwarden.com)
API keyYour organization's Hub API key (starts with pwc_). Obtain this from the Hub dashboard
Instance NameA friendly name for this PodWarden instance (e.g. "Home Lab", "Production", "Staging"). Shown in the Copy to PodWarden dialog when you have multiple instances connected to the same Hub organization. If left blank, falls back to the server's SERVICE_NAME environment variable.
ConnectedRead-only indicator showing whether the current configuration can reach Hub

Available actions

ActionWhat it does
SavePersists the Hub connection settings
Test connectionSends a request to the Hub API using the configured URL and API key. Reports success (with organization name) or the specific error

What the Hub connection enables

  • Import from Hub button on the Apps & Stacks page
  • Check for updates on imported stacks (compares local version to Hub version)
  • Access to public templates and any private templates your organization has access to

Notes

  • The API key is scoped to your Hub organization. It determines which templates you can see (public + your organization's private templates).
  • The key is shown only once when created on Hub. If lost, generate a new one from the Hub dashboard.
  • The Hub URL should not include a trailing slash or path segments.
  • If you manage multiple PodWarden instances connected to the same Hub account, set a distinct Instance Name on each one so you can tell them apart in the Hub UI.

Related docs

Settings: Tailscale

Tailscale VPN integration for mesh networking and host discovery

Settings: DDNS

Dynamic DNS configurations for automatic IP address updates

Settings: Hub | PodWarden Hub