Skip to content
podmaker docs

Deploy your first site

This guide takes a Git repo to a running site.

1. Write the manifest

site.yml
apiVersion: podmaker.sh/v1alpha
kind: Site
metadata:
  name: blog
targets:
  - server: demo-01
source:
  type: git
  repo: https://github.com/acme/blog.git
  branch: main
runtime:
  type: node
  version: "20"
  build:
    command: npm ci && npm run build
    output_dir: dist
  start:
    command: node server.js
    port: 3000
    healthcheck: /healthz

2. Validate

Terminal window
pdctl validate site.yml

3. Apply

Terminal window
pdctl apply -f site.yml

podmaker clones the repo, runs the build, provisions a database if the app needs one, injects its credentials into the environment, and starts the app behind Caddy.

4. Watch it come up

Open the panel’s site overview, or stream logs from the deploy. The first deploy obtains a certificate once you attach a domain — see Domain & SSL.

Next