Catalog

What you see

URL: /catalog (list), /catalog/[slug] (detail)

The catalog is a public page (no login required) that lets anyone browse PodWarden's template library. The layout has a hero section with a search bar at the top, then a two-column layout with a category sidebar on the left and a template grid on the right.

List page layout

• Search bar — Full-text search across template names and descriptions. Debounced (300ms delay) so results update as you type.
• Category sidebar — Lists all categories with template counts. Click a category to filter. Click "All" to reset. Shows the total template count at the top.
• Sort dropdown — Top-right of the grid. Options: Most Popular (default), Recently Updated, Name A-Z, Newest.
• Template count — Shows the number of matching templates, including the active category and search term.
• Template grid — Cards showing template name, icon, category, description snippet, and resource badges. 48 templates per page.
• Pagination — Page navigation at the bottom of the grid.

Detail page layout

URL: /catalog/[slug]

Clicking a template card opens its dedicated detail page with a two-column layout:

Main column (left):

• Breadcrumb — Catalog > Category > Template Name
• Hero — Large icon, template name, Docker image reference, registry badge, description
• Badges — Category, tier (Free/Pro/etc.), PodWarden Approved, Security Audited, Host Network, Preserved (registry cached)
• Stats — Docker pulls, GitHub stars, last updated, deploy count, tags
• About section — Expandable markdown content with "Read more" toggle
• Screenshots — Image carousel with navigation arrows and dot indicators

Sidebar (right):

• Self-host with Docker button — Opens the install command modal (see below)
• Author — Author name with link to project page
• Stack selector — If the application has multiple stacks (e.g. single service and compose stack), a dropdown lets you choose which one to view or install
• Requirements — Workload type, CPU, RAM, GPU, VRAM, ports, volumes, command, node selector, tolerations
• Environment Variables — Expandable list with name, description, default value, required flag, and generate hint
• Requires — Required dependencies grouped by alternative group
• Versions — Latest tag plus 3 recent versions with publish dates

Install command modal

Clicking Self-host with Docker opens a modal with everything needed to run the template on any server with Docker:

• One-line install command — A curl | bash command that downloads, extracts, generates secrets, and starts the app. Copy button included.
• Advanced options (expandable):
  • Stack selector — Choose between available stacks if the application offers multiple (single service vs compose stack)
  • Install directory — Override the default /opt/<app-slug>/ path
  • Auto-generate secrets — Checkbox (on by default). When enabled, the installer uses openssl rand to generate random values for passwords, secret keys, and other env vars with generate hints. Disable with --no-generate-secrets.
• Download bundle manually — Direct link to download the .tar.gz bundle without running the script

The bundle contains: docker-compose.yml, .env.example (copied to .env on install), and any config files declared in the template's config schema.

Fields / columns (grid cards)

Available actions

Related docs

• Stack Templates — Full documentation on applications, stacks, and the installer
• Templates — Authenticated template browser in the dashboard
• Admin Templates — Admin template management
• Admin Categories — Admin category management