Docs

Quick start

Bring up Approving on a Linux host with Docker Compose.

Prerequisites

  • A Linux host
  • Git, Docker, and Docker Compose installed

Clone the repository

git clone https://github.com/cocofhu/approving.git
cd approving

Start

By default this pulls published images from GHCR (no local image build required):

./start.sh -d

Then open:

./start.sh also pulls the sandbox runtime image from GHCR (large). Until that finishes, sandbox chats may stay on “starting sandbox…”.

Common commands

./start.sh logs
./start.sh down
./start.sh pull          # refresh GHCR images
./start.sh dev -d        # source stack: go run + Vite HMR

Image tags / digests can be overridden in .env — see .env.example at the repo root. Publish and smoke checks are covered in Contributing.

Next steps