Admin Portal

Overview

Hub admins (admin or superadmin role) have access to additional dashboard pages for managing the catalog, users, and organizations. The admin section appears in the sidebar under the ADMIN heading.

Admin Overview

The admin home page shows system-wide stats:

• Users — Total registered user count
• Organizations — Total organization count
• API Keys — Active API keys across all orgs
• Templates — Total template count (public + private)
• Categories — Total category count

Each stat card links to its management page.

Template Management

Navigate to Admin → Templates to create, edit, and delete catalog templates.

Browsing Templates

Templates are organized by category. Each template row shows:

• Name, container image, and resource requirements (CPU, RAM, GPU)
• Click the chevron to expand full details

The search bar filters templates by name, image name, or category.

Creating a Template

1. Click Create Template
2. Fill in the template form:

Basic fields:

Resources:

Catalog settings:

Environment Variables:

Static Environment Variables — Fixed key-value pairs applied to every deployment:

• Click Add Variable to add a new entry
• Enter the variable Name and Value
• Click X to remove a variable

Configurable Environment Variables — Schema-defined variables that operators can customize:

• Click Add Variable to add a new entry
• Enter the variable Name
• Check Required if the variable must be set
• Enter a Default Value (optional)
• Enter a Description explaining what the variable controls
• Click X to remove a variable

Documentation:

• Markdown text area for usage instructions, configuration examples, and tips

3. Click Create

Editing a Template

Click the pencil icon on any template to open the edit form. All fields from creation are editable. Click Update to save changes.

Deleting a Template

Click the trash icon on any template. The template is permanently removed from the catalog.

Category Management

Navigate to Admin → Categories to manage template categories.

Viewing Categories

Each category row shows:

• Icon and name
• Slug — URL-friendly identifier
• Sort order — Display order in the catalog
• Description
• Template count — Number of templates in this category
• Private badge — If the category is private (with lock icon)
• Access count — Number of organizations with access (private categories only)

Creating a Category

1. Click Add Category
2. Fill in:

3. Click Create

Private Categories

When Is Private is checked, the category and all its templates are hidden from users and API keys unless their organization has an explicit access grant.

Private categories show:

• A lock icon with "Private" badge
• A users icon with the count of organizations that have access
• A Manage Access button

Managing Category Access

Click the users icon on a private category to manage which organizations can see it:

1. The modal shows all organizations currently with access
2. To grant access: Select an organization from the dropdown and click Grant
3. To revoke access: Click the delete button next to any organization

Only organizations with an active access grant can see the private category's templates via API key.

Deleting a Category

Click the trash icon to delete a category. Deletion is blocked if the category still contains templates — move or delete the templates first.

User Management

Navigate to Admin → Users to view and manage all registered users.

Viewing Users

Each user row shows:

• Name and email
• Organization (if any)
• Last login timestamp
• Role badge

Use the search bar to filter by name, email, or organization.

Changing User Roles

1. Click the role badge to switch to edit mode
2. Select a new role from the dropdown:
   • user — Standard access
   • admin — Full admin access
   • superadmin — Superadmin access (only visible if you are a superadmin)
3. Click Save

Organization Management

Navigate to Admin → Organizations to manage all organizations.

Viewing Organizations

Each organization row shows:

• Name and slug
• Member count and API key count
• Creation date
• Tier — free, pro, enterprise, or business
• Status — active, suspended, or deleted

Use the search bar to filter by name or slug.

Changing Tier or Status

1. Click the tier or status badge to switch to edit mode
2. Select the new value from the dropdown
3. Click Save

Managing Catalog Access from Organizations

Click the lock icon on any organization to manage its private category access:

1. The modal shows all private categories the organization currently has access to
2. To grant access: Select a category from the dropdown and click Grant
3. To revoke access: Click the delete button next to any category

This is the reverse view of category access management — same data, accessed from the organization side.

API Key Oversight

Navigate to Admin → API Keys to view all API keys across all organizations.

Viewing Keys

Each key row shows:

• Name
• Key prefix (first 8 characters)
• Organization
• Status (active/revoked)
• Last used timestamp
• Creation date

Use the search bar to filter by key name, organization, or prefix.

Revoking Keys

Click the trash icon on any active key to permanently revoke it. This immediately invalidates the key — any PodWarden instances using it will lose Hub access until configured with a new key.