# Operations Guide

## Install

```bash
./install.sh
```

The installer is idempotent:

- existing `.env` is kept;
- existing Docker/Compose installation is reused;
- repeated image loading is safe;
- existing data directory is reused.

## Start

```bash
./start.sh
```

Start without waiting for the first snapshot:

```bash
./start.sh --no-wait-first-run
```

## Stop and Restart

```bash
./stop.sh
./restart.sh
```

## Status Checks

```bash
./status.sh
./self-check.sh
```

Important checks:

- Docker/Compose availability;
- runtime image exists;
- `HOST_DATA_DIR` is writable;
- Compose config is valid;
- latest run status;
- metrics, Prometheus and Grafana endpoints.

## Upgrade

Extract the new package, reuse the existing `.env` and `HOST_DATA_DIR`, then run:

```bash
./upgrade.sh
```

Upgrade does not delete runtime data.

## Cleanup

```bash
./cleanup.sh --keep-runs 100
./cleanup.sh --keep-runs 100 --execute
```

Cleanup is dry-run by default. Add `--execute` after reviewing the output.