Getting Started

# macOS
brew install joonapay/tap/pier

# Linux (amd64/arm64)
curl -fsSL https://pier.wejoona.com/install.sh | bash

# Verify installation
pier --version

mkdir myapp && cd myapp
pier init

# This creates pier.yml with a starter template

services:
  api:
    build: ./api           # Build from Dockerfile
    port: 3000
    domain: api.myapp.dock # Automatic local HTTPS
    health: /api/health    # Wait for this before "ready"
    env:
      DATABASE_URL: postgres://db:5432/myapp

  web:
    build: ./web
    port: 5173
    domain: myapp.dock
    depends_on: [api]      # Start after API is healthy

  db:
    image: postgres:16
    port: 5432
    volumes:
      - pg_data:/var/lib/postgresql/data
    env:
      POSTGRES_DB: myapp
      POSTGRES_PASSWORD: dev

  redis:
    image: redis:7-alpine
    port: 6379

$ pier up

  ✓ Building api...
  ✓ Building web...
  ✓ Starting db (postgres:16)
  ✓ Starting redis (redis:7-alpine)
  ✓ Starting api (./api)
  ✓ Health check passed: api → 200 OK
  ✓ Starting web (./web)
  ✓ HTTPS certs issued for myapp.dock, api.myapp.dock
  ✓ Dashboard: http://localhost:9090

  Ready. 4 services running.

  api   → https://api.myapp.dock
  web   → https://myapp.dock
  db    → localhost:5432
  redis → localhost:6379