User Manual

This section is a systematic reference for every page in the PodWarden UI and PodWarden Hub. Each page documents what you see, what every field means, what each button does, and which status badges you may encounter.

How to use this manual

Looking for a specific screen? Use the sidebar to navigate directly to the page.
Want to learn how to accomplish a task? See the Guides section instead.
Need API details? See the API Reference.

Sections

PodWarden (self-hosted)

The PodWarden dashboard you run on your own infrastructure. Covers every page from login to settings.

Page	What it shows
Login	Authentication screen with OIDC and local login
Dashboard	Infrastructure overview with host and deployment counts
Clusters	K3s clusters, nodes, and live status
Hosts	Server inventory with hardware details
Apps & Stacks	Application templates with images, resources, and config
Deployments	Template-to-cluster assignments with deployment status
Ingress	Ingress rules, domains, and TLS certificates
Storage	NFS and other storage connections
Backups	Backup policies, schedules, and snapshots
Deployments	Deployment history with rollback
Provisioning	Server provisioning jobs and logs
Settings	System config, Tailscale, Hub, DDNS, MCP, Users, Secrets

PodWarden Hub (SaaS)

The cloud service at www.podwarden.com. Covers public pages, user dashboard, and admin portal.

Page	What it shows
Landing	Marketing homepage and feature overview
Pricing	Subscription tiers and feature comparison
Catalog	Public template catalog with search and categories
Dashboard	User dashboard with organization and stats
API Keys	API key management for PodWarden integration
DDNS	Dynamic DNS subdomain allocation
Templates	Template browser with detail panel
MCP	MCP server configuration for AI agents
Settings	Profile and organization settings
Admin	Admin portal for managing all users, orgs, and content