Quick Start

Clone and configure

git clone https://github.com/the-luap/picpeak.git
cd picpeak
cp .env.example .env

Generate secure secrets and edit .env:

# Generate values
openssl rand -base64 64    # use for JWT_SECRET
openssl rand -base64 32 | tr -d '$'  # use for DB_PASSWORD
openssl rand -base64 32 | tr -d '$'  # use for REDIS_PASSWORD

Open .env and set these three values:

JWT_SECRET=<paste generated value>
DB_PASSWORD=<paste generated value>
REDIS_PASSWORD=<paste generated value>

Create storage directories

mkdir -p events/active events/archived data logs backup storage

The backend container will chown these to its internal nodejs user on first boot — no PUID/PGID setup needed. If you’ve pinned user: in a compose override, see Permissions for the manual pre-chown step.

Start PicPeak

docker compose -f docker-compose.production.yml pull
docker compose -f docker-compose.production.yml up -d

docker compose up -d

Wait for all containers to report as healthy:

docker compose ps

Open PicPeak

Open http://localhost:3000 in your browser. The admin panel is at http://localhost:3000/admin.