Templates
A template is a ready-made, deployable kuploy stack — a self-contained stack spec plus a catalog entry — that you can stand up in one click. Browse the catalog at kuploy.app/templates or from your kuploy dashboard.
A template provisions a whole stack (one or more applications + their databases, wired together), not a single service. See Stacks for what a stack is.
Deploy a template (one click)
From a project environment:
- Open the Stacks tab and click Templates.
- Pick a template and click Deploy.
kuploy then provisions every component the template declares — applications and databases — generates the secrets it needs, assigns any required domains, and deploys the stack. You land on the new stack's page to watch it roll out.
Behind the scenes this runs the catalog's stack spec in provisioning mode (it creates services from scratch), so you don't pre-create anything.
Import from the gallery (manual)
You can also browse kuploy.app/templates, open a template, and choose Import into kuploy to copy its stack spec (YAML). Paste it into Stacks → Import in your environment. The import dialog offers two modes:
- Provision new services — creates each component from the spec (the same thing one-click deploy does). Use this for a fresh deploy.
- Wire existing services — matches components to services that already exist in the environment by name; it does not create anything. Use this to wrap a stack around services you already run.
Access tiers
Each template has an access tier:
| Tier | Who can deploy it |
|---|---|
free | Anyone. |
pro / cloud | Requires an active paid plan. |
If you try to deploy a paid template your plan doesn't include, kuploy shows an upgrade prompt instead of deploying. Which plans include which templates is set by your platform operator — see Plans & Usage.
Per-template notes
Some stacks need more than HTTP. For example, LiveKit (WebRTC) needs UDP ports and a TURN path reachable from clients; check the template's links and the upstream project's docs for networking requirements before going to production.
Publishing a template
Want to add a template to the catalog? Authoring lives in the
kuploy/kuploy-templates repo —
see its docs/AUTHORING.md
for the catalog schema, self-contained specs, and access tiers.