# Runbook

## Daily checks

```bash
docker compose ps
docker compose logs --since 1h --tail 100
./verify.sh
```

## Common problems

**WireMock returns 404 for everything.** No stubs are loaded yet. Put mappings
in the mounted volume under `mappings/` and restart, or POST them to
`/__admin/mappings`.

**Prism needs the spec.** Point it at an OpenAPI file: it will not invent
endpoints. Mount your spec and pass the path.

**Traefik shows no routers.** Traefik only sees containers on the same Docker
network with labels set. Add `traefik.enable=true` and the router labels to the
service you want exposed.

**Caddy cannot get a certificate.** Automatic HTTPS needs a real domain that
resolves to the host, with ports 80 and 443 open. `localhost` will not issue.

**Kong migrations.** Run `kong migrations bootstrap` once before first start,
against the same database, or the gateway will refuse to boot.

**Mockoon CLI needs a data file.** Mount your environment JSON and pass it with
`--data`.

## Backups

```bash
docker run --rm -v meridian_wiremock_data:/data -v "$PWD":/backup \
  alpine tar czf /backup/wiremock-$(date +%F).tgz -C /data .
```

Stop the service before backing up.

## Sizing

| Setup | Minimum |
|---|---|
| Clients and one mock | 2 GB RAM |
| Adding mock servers | 4 GB RAM |
| Adding gateway and platform | 8 GB RAM |

## Services in this tier

- `mockoon`
- `wiremock`
- `mockserver`
- `prism`
- `traefik`
- `caddy`
- `kong`