Creating App Templates
As an admin, you can create app templates that users deploy from the marketplace. Templates define the Docker image, default configuration, and resource requirements.
Creating a New Template
- Navigate to Admin → App Templates.
- Click New Template.
- Fill in the template details:
- Name — Template display name.
- Slug — URL-friendly identifier (auto-generated from name).
- Description — Detailed description for the marketplace listing.
- Category — Template category (CMS, tools, e-commerce, etc.).
- Docker Image — The base Docker image to use.
- Default Environment Variables — Pre-configured variables that users can override.
- Ports — Which port the application exposes.
- Min Plan — Minimum required plan tier.
GitHub Integration
Connect your template to a GitHub repository:
- Select a connected GitHub App repository.
- Define the branch to deploy from.
- The template can auto-build from the repository's Dockerfile.
Publishing
- After saving the template, it's in draft mode.
- Review all settings and test a deployment.
- Click Publish to make it available in the marketplace.
- Published templates are immediately visible to all users.
Editing Templates
Update an existing template:
- Click the template from the App Templates list.
- Modify any fields and click Save.
- Changes to published templates take effect immediately for new deployments.
- Existing deployments are not affected by template changes.