Is picpeak still maintained?

Yes, active. Last change today. Latest release v3.135.11, yesterday.

Some track record. 362 stars, 1 years old, by an organization. Get it from the official repo and read what it installs.

Reading the repo

Opening the box…

How to install picpeak on macOS (PicPeak/picpeak) · gitmanual

How to install on macOS

PicPeak/picpeak

Open-source, self-hosted photo and video galleries for photographers and events, with client proofing, password protection, guest uploads, custom branding and Docker deployment.

Node.js#client-gallery#docker#event-photography#gallery

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change today. Latest release v3.135.11, yesterday.
Can I trust it?: Some track record362 stars, 1 years old, by an organization. Get it from the official repo and read what it installs.

Difficulty: Involved
Time: 30 min or more
Stars: ★ 362
Activity: Updated this month
Got it running: 1 person

Saved setup from 1 h ago

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Website ↗picpeak.appThe project's own site.

Also: Docs ↗

Heads-upBuilding it yourself? It also needs PostgreSQL, Redis, Mail catcher and 39 settings in .env (3 secret).

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker compose up -d

Docker

docker run -d --name picpeak -p 127.0.0.1:3000:3000  -e COOKIE_SECURE=auto  -v picpeak:/data  ghcr.io/picpeak/picpeak/aio:stable

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 14 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js 22runtime
1×Docker tool
1×npm package manager
1×PostgreSQL service
1×Redis service
1×Mail catcher service

39× settings in .env

VITE_API_URL
NODE_ENV
DATABASE_CLIENT
DB_USER
DB_NAMEoptional
BRAND_TITLE
BRAND_DESCRIPTION
PICPEAK_CHANNEL
UPDATE_CHECK_ENABLED
TZ
APP_STORAGE
APP_DATA
LOGS
APP_BACKUP
PUBLIC_UPLOAD_LIMITS_JSONoptional
ADMIN_UPLOAD_LIMITS_JSONoptional
ANALYTICS_ALLOW_INSECURE_HTTP
PORT
JWT_SECRETsecret
ADMIN_URL
FRONTEND_URL
BACKEND_URL
API_URL
DB_HOST
DB_PORT
DB_PASSWORDsecret
SMTP_HOST
SMTP_PORT
SMTP_SECURE
SMTP_USER
SMTP_PASSsecret
EMAIL_FROM
STORAGE_PATH
EVENTS_PATH
ARCHIVE_PATH
LOG_LEVEL
STRIPE_SECRET_KEYsecretoptional
STRIPE_WEBHOOK_SECRETsecretoptional
PAYMENTS_ENCRYPTION_KEYsecretoptional

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/PicPeak/picpeak/badge.svg)](https://gitmanual.com/PicPeak/picpeak)

Good to know

Nested projects: backend/package.json, frontend/package.json, ml/requirements.txt

Details

License: MIT
Open issues: 38
Branch: main

package.json scripts (1)

test:e2eplaywright test

Files we read (14)

.env.example

.github/workflows/branch-cleanup.yml

.github/workflows/bypass-size-gate.yml

.github/workflows/docker-build.yml

.github/workflows/e2e.yml

.github/workflows/pr-title-lint.yml

.github/workflows/tests.yml

CONTRIBUTING.md

README.md

backend/.env.example

docker-compose.yml

frontend/.env.example

frontend/.env.production.example

package.json

3,699 files in the repo

Yes, with Docker on macOS

Start here

Run it with Docker

Did you get it running?

Still stuck? Get a written guide

More like picpeak that run on macOS