Dashboard | PodWarden Hub

Overview

The PodWarden Hub dashboard at www.podwarden.com is your portal for managing your organization, API keys, and browsing the workload catalog.

Dashboard Home

The home page shows:

Welcome message — Personalized with your name
Organization status — Your org name and current subscription tier
API Keys — Count of active instance keys, linking to the MCP page where they are managed
Catalog — Quick link to browse stack templates
DDNS — Quick link to manage your DDNS subdomains

If you haven't created an organization yet, a setup prompt guides you to Settings to create one. An organization is required before you can create API keys, manage DDNS subdomains, or access private templates.

DDNS

Navigate to Dashboard → DDNS to manage your Hub DDNS subdomains. From here you can allocate new subdomains, view their status, and release unused ones.

See Hub DDNS Subdomains for the full guide.

Instance Keys and Access Tokens

Keys and tokens are managed on Dashboard → MCP (MCP access). There is no separate API Keys page.

Creating an Instance Key

Open Dashboard → MCP and click + Connect something
Enter a descriptive name (e.g. "Production PodWarden")
Click Mint key
Copy the key immediately — it starts with pwh_ and is shown only once

The key binds to the first Core that connects with it (trust-on-first-use) and refuses every other, so use one key per Core.

Each connection on the MCP page shows its key's status, pin, and last use, with Rotate (mint a replacement and keep both valid for a grace window) and Revoke controls. Keys that no Core has used yet are listed under Unused keys.

Personal access tokens (pwp_), the separate credential an AI client presents to Hub's MCP endpoint, are minted from Connect an AI client on a connection's card. See Hub MCP Proxy.

Settings

Navigate to Dashboard → Settings to manage your profile and organization.

Profile

Your profile shows:

Email — From your SSO login (read-only)
Name — Your display name (read-only)

Organization

Every Hub account belongs to an organization. Organizations scope API keys, private catalog access, and subscription tiers.

Creating an organization (first time):

Go to Dashboard → Settings
Enter your Organization Name (e.g. "Acme Corp")
The Slug is auto-generated from the name (e.g. acme-corp) — you can edit it manually
Click Create Organization

The slug is used in URLs and API access. Choose something short and URL-friendly.

After creation, the settings page shows your organization name, slug, and current subscription tier.

Using API Keys

API keys authenticate your PodWarden instances against the Hub catalog API. Each key:

Is scoped to your organization
Sees public templates + your org's private templates + any private categories you have access to
Tracks usage (last-used timestamp)

In PodWarden

Configure the key in your PodWarden instance:

Go to Settings → Hub in PodWarden
Enter https://apps.podwarden.com as the Hub URL
Paste your API key
Click Test Connection

See Connecting to Hub for the full setup guide.

Via API

Use the key directly in API calls:

curl -H "Authorization: Bearer pwh_your_instance_key_here" \
  https://apps.podwarden.com/api/v1/catalog/templates

See the Catalog API reference for all available endpoints.