Dashboard

Overview

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

Sign in with your account (Google or GitHub via SSO) to access the dashboard.

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 API keys with a link to manage them
• 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.

API Keys

Navigate to Dashboard → API Keys to manage your organization's API keys.

Creating a Key

1. Click Create Key
2. Enter a descriptive name (e.g. "Production Fleet", "Staging PodWarden")
3. Click Create
4. Copy the key immediately — it starts with pwc_ and is shown only once

The key is displayed in a code block with a copy button. Dismiss the success message when you're done.

Key Details

Each key shows:

• Name — The label you gave it
• Prefix — First 8 characters of the key (e.g. pwc_a1b2c3d4...)
• Status — Active or revoked
• Last Used — Timestamp of the most recent API call

Re-issuing a Key

Click the refresh icon on any active key to generate a new secret while keeping the same key name. The old key stops working immediately. Copy the new key — it's shown only once.

Use this when a key may have been compromised but you want to keep the same key entry.

Revoking a Key

Click the trash icon on any active key to permanently deactivate it. Revoked keys cannot be re-activated — create a new key instead.

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):

1. Go to Dashboard → Settings
2. Enter your Organization Name (e.g. "Acme Corp")
3. The Slug is auto-generated from the name (e.g. acme-corp) — you can edit it manually
4. 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:

1. Go to Settings → Hub in PodWarden
2. Enter https://apps.podwarden.com as the Hub URL
3. Paste your API key
4. 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 pwc_your_api_key_here" \
  https://apps.podwarden.com/api/v1/catalog/templates

See the Catalog API reference for all available endpoints.