> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slipway.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

> Worked specs for common shapes.

## Static site or single-binary web app

```yaml slipway.yaml theme={"system"}
version: 1

services:
  web:
    build:
      context: .
    ports:
      - { port: 3000, public: true }
    env:
      NODE_ENV: production
    healthcheck:
      readiness: { http: { path: /api/health, port: 3000 } }
```

## Web + worker (no public port for the worker)

```yaml slipway.yaml theme={"system"}
version: 1

services:
  web:
    build:
      context: .
    ports:
      - { port: 3000, public: true }
    env:
      LOG_LEVEL: ${var.LOG_LEVEL}
      DATABASE_URL: ${secret.DATABASE_URL}
      REDIS_URL: ${secret.REDIS_URL}
    healthcheck:
      readiness: { http: { path: /healthz, port: 3000 } }

  worker:
    image: ghcr.io/acme/worker:1.2.3
    env:
      LOG_LEVEL: ${var.LOG_LEVEL}
      DATABASE_URL: ${secret.DATABASE_URL}
      REDIS_URL: ${secret.REDIS_URL}
    healthcheck:
      liveness: { exec: { command: [/usr/local/bin/worker-healthcheck] } }
```

`web` is reachable at `<env-name>-web-<id>.<apps-base>`. `worker` has no ports — internal-only, no URL, no readiness gate.

`DATABASE_URL` and `REDIS_URL` resolve from the [environment or org secret store](/slipway-yaml/secrets-and-variables) (environment first, org fallback) — never from this file.

## Custom build args + private registry pull

```yaml slipway.yaml theme={"system"}
version: 1

services:
  api:
    build:
      context: ./api
      dockerfile: Dockerfile.prod
      args:
        NPM_TOKEN: ${secret.NPM_TOKEN}
        BUILD_REV: ${var.BUILD_REV}
    ports:
      - { port: 8080, public: true }
    env:
      DATABASE_URL: ${secret.DATABASE_URL}
    healthcheck:
      readiness: { tcp: { port: 8080 } }
      liveness:  { http: { path: /metrics, port: 8080 } }

  cache:
    image: ghcr.io/acme/private-cache:tag
    ports:
      - { port: 6379 }
```

`cache` pulls from a private registry. Configure the credentials once at the org level under **Settings → Registries** (see [Private registries](/configuration/registries)) — no per-service config is needed.

## Custom domain for one public port

```yaml slipway.yaml theme={"system"}
version: 1

services:
  web:
    build: { context: . }
    ports:
      - { port: 3000, public: true, domain: app.acme.com }
    healthcheck:
      readiness: { http: { path: /healthz, port: 3000 } }
```

`app.acme.com` must be a verified parent zone for the org (claim and verify it under **Settings → Domains** first — see [Custom domains](/configuration/domains)). The deployed URL becomes `<env-name>-web-<id>.app.acme.com`, where `<id>` is the short, stable identifier for the environment-instance.