Reading the repo

Opening the box…

How to install photoprism on Linux (photoprism/photoprism) · gitmanual

How to install on Linux

photoprism/photoprism

AI-Powered Photos App 🌈💎✨

Node.jsGo#ai#golang#google-photos#machine-learning

Difficulty: Involved
Time: 30 min or more
Stars: ★ 40,415
Activity: Updated this month
License: Not detected
Open issues: 452
Got it running: Be the first
Looked up: 13 h ago

GitHub didn't answer, so this is the saved copy from 13 h ago

Start here

Website ↗photoprism.appThe project's own site.Docs ↗docs.photoprism.appLinked from the README.

Setup script in the repo

The maintainers included scripts/install-qemu.sh. Run it from the cloned folder after reading it.

bash scripts/install-qemu.sh

Will it work on my device?

Yes, it installs on your Linux

A ready-made Linux download is in the latest release.

Checking for

macOS Windows Linux

Download for Linux

October 29, 2026 · 10/29/2026 ↗

photoprism_261029-963b58c50-linux-amd64.tar.gz

tar.gz · x64 · 426.0 MB · 466 downloads · best match

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/photoprism/photoprism/releases/download/261029-963b58c50/photoprism_261029-963b58c50-linux-amd64.tar.gz"
tar -xzf "photoprism_261029-963b58c50-linux-amd64.tar.gz"

Other Linux downloads (1)

photoprism_261029-963b58c50-linux-arm64.tar.gz

tar.gz · ARM64 · 401.0 MB · 53 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/photoprism/photoprism/releases/download/261029-963b58c50/photoprism_261029-963b58c50-linux-arm64.tar.gz"
tar -xzf "photoprism_261029-963b58c50-linux-arm64.tar.gz"

Did you get it running?

No reports for Linux yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for Linux. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js LTS (no version pinned)runtime
1×Go 1.27runtime
1×npm package manager
1×MariaDB service
1×PostgreSQL service
1×Vector DB service

Share this manual

Is this your repo?

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

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

Good to know

Monorepo (workspaces) — install from the repo root.
Dockerfile available (base image: photoprism/develop:261027-resolute).
Makefile has a make install target — it may automate most of these steps.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: docker/dummy/oidc/app/go.mod, frontend/package.json

Files we read (9)

.env.example

.github/workflows/codeql-analysis.yml

CONTRIBUTING.md

Dockerfile

Makefile

README.md

compose.yaml

go.mod

package.json

Branch develop · 6,896 files in the repo