Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

1. 1

   Clone the repository

   Needs Git: xcode-select --install

   git clone https://github.com/ephremdushime/restourant.git
   cd restourant

   Copy
2. 2

   Install the required runtimes

   Node.js 22, Bun, Docker

   # needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm)
   nvm install 22
   curl -fsSL https://bun.sh/install | bash
   brew install --cask docker  # Docker Desktop

   Copy
3. 3

   Configure environment variables

   Fill in secrets: SESSION_SECRET, RESTOPASS_MASTER_SECRET, POSTGRES_PASSWORD, REDIS_PASSWORD, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY, RESTOPASS_BACKUP_ENCRYPTION_KEY, RESTOPASS_BACKUP_HMAC_KEY

   cp .env.example .env

   Copy
4. 4

   Start backing services

   Needs: Redis, PostgreSQL (no compose file — install locally or run via Docker)

5. 5

   Install dependencies

   bun install

   Copy
6. 6

   Run it

   bun run dev

   Copy
7. 7

   Run the tests

   bun run test

   Copy

# 1. Clone repository & configure production secrets
cp .env.example .env
nano .env

# 2. Launch production stack with PostgreSQL 16, Redis 7, and RestoPass App
docker compose --project-directory . --env-file .env -f deploy/docker-compose.prod.yml up -d --build

# 3. Check container health status
docker compose --project-directory . --env-file .env -f deploy/docker-compose.prod.yml ps