Templates

Templates let you start with a working app that’s pre-configured for Podway. Each template includes a Dockerfile, a /health endpoint, and sensible defaults.

Available templates

Using a template

1. Click New app inside a project
2. Select the From template tab
3. Pick a template
4. Enter your app name
5. Click Create

Podway will:

• Create a private GitHub repository in your account named after your app
• Push the template files to it

After creation, you’ll see a banner with the repository name. Connect it to Podway by clicking Connect repository and selecting it from the list.

Customizing a template

Templates are just a starting point. After connecting the repository:

1. Clone it to your machine
2. Make your changes
3. Push to GitHub
4. Trigger a build

Template structure

Each template follows the same conventions:

• Listens on port 8080 (Podway’s default)
• Has a GET /health endpoint returning {"status":"ok"}
• Has a production-ready Dockerfile

Dockerfile requirements

If you’re not using a template, your Dockerfile must:

• Expose the port your app listens on
• Match the port configured in Podway’s resource settings (default: 8080)