# Dev

Self-contained local development stack. Spin up all shared infrastructure on a per-project basis.

## Services

| Service            | Description                              | Port(s)        |
| ------------------ | ---------------------------------------- | -------------- |
| **PostgreSQL**     | Primary relational database              | `5432`         |
| **Valkey**         | Redis-compatible cache / message broker  | `6379`         |
| **SigNoz**         | Observability UI (traces, metrics, logs) | `8080`         |
| **OTel Collector** | OpenTelemetry ingest (gRPC / HTTP)       | `4317`, `4318` |
| **ClickHouse**     | Telemetry storage backend for SigNoz     | —              |

## Run

```sh
cd dev
docker compose -f docker-compose.dev.yaml up -d
```

## Stop

```sh
docker compose -f docker-compose.dev.yaml down
```

To also remove all persisted data volumes:

```sh
docker compose -f docker-compose.dev.yaml down -v
```

## Connection strings

| Resource   | Default value                                             |
| ---------- | --------------------------------------------------------- |
| PostgreSQL | `postgresql://postgres:postgres@localhost:5432/primarydb` |
| Valkey     | `redis://localhost:6379`                                  |
| SigNoz UI  | `http://localhost:8080`                                   |
| OTLP gRPC  | `localhost:4317`                                          |
| OTLP HTTP  | `localhost:4318`                                          |