Docker Compose Deployment

The easiest way to run HelpNest in production is with Docker Compose.

What is included

The provided docker-compose.yml runs:

• HelpNest — the Next.js app (port 3000)

• PostgreSQL 16 — primary database

• Redis 7 — caching and sessions

• Qdrant — vector database for AI search

Steps

1. Clone the repo on your server

   git clone https://github.com/babble-open-source/helpnest
   cd helpnest

2. Create your .env file

   cp .env.example .env

3. Start everything

   docker compose up -d

4. Run migrations and seed

   docker compose exec app pnpm --filter @helpnest/db db:migrate
   docker compose exec app pnpm --filter @helpnest/db db:seed

5. Visit your server on port 3000.

Updating

git pull
docker compose build app
docker compose up -d