HomeGallery

Self-hosted photo organization, honestly reviewed. No marketing fluff, just what you get when you deploy it yourself.

TL;DR

• What it is: Open-source (MIT) self-hosted web gallery for browsing personal photos and videos, with AI-powered image search, face recognition, and geo lookups — all running on your own hardware [README][4].
• Who it’s for: Technically inclined individuals (the README explicitly says “computer affine users who solve their own problems”) who want to stop uploading family photos to Google Photos, iCloud, or Amazon [README].
• Cost savings: Google Photos charges $2.99–$9.99/mo for storage above 15GB. Amazon Photos costs $1.99/mo if you’re not a Prime subscriber. HomeGallery is $0 in license cost, running on whatever server or NAS you already own.
• Key strength: Reverse image search without manual tagging — you find all your sunset photos by clicking one sunset photo, not by hand-labeling thousands of images [README][1].
• Key weakness: Single-user only by design, no cloud/SaaS option, CLI-required setup, and the maintainer explicitly calls it a “private pet/spare time project without any warranty” [README]. If you need multi-user or want to hand a URL to a non-technical family member to set up, this isn’t the tool.

---

What is HomeGallery

HomeGallery is a self-hosted web gallery that sits on top of your existing folder structure. Point it at ~/Pictures, run one command, and you get a mobile-friendly browser interface over your photos and videos — including AI-powered similar image search, face detection, GPS-based location lookups, and flexible tag-based filtering [README][4].

The project was started in 2019 by a single developer (GitHub user xemle) to scratch a specific itch: NAS-stored photos, privacy concerns with cloud services, and no existing gallery that felt fast on mobile [README]. As of this review it sits at 1,099 GitHub stars — a small community compared to PhotoPrism (30k+) or Immich (50k+), but the codebase is active and the feature set is more complete than the star count suggests.

The GitHub description is unusually honest: “Self-hosted open-source web gallery to view your photos and videos featuring mobile-friendly, tagging and AI powered image discovery.” The README goes further: “This software is a private pet/spare time project without any warranty.” That’s the kind of transparency that matters when you’re choosing what to trust with fifteen years of family photos.

The MIT license means no usage restrictions, no “you can’t use this commercially” fine print, and no vendor lock-in [4]. One language (TypeScript) for both frontend and backend, which matters if you ever need to debug or extend it [README].

---

Why people choose it

The reviews and roundups that mention HomeGallery (it appears in multiple “best self-hosted gallery” lists) land on a consistent pitch: it’s the option for people who want Google Photos-style AI discovery without sending their photos to Google [1][2][4].

The AI angle is the differentiator. The killer feature isn’t the gallery itself — it’s what the README calls “reverse image lookup (similar image search).” The demo site illustrates this directly: click one food photo, find all your food photos. Click a sunset, find all your sunsets. No tagging required [README]. Medevel’s 2024 roundup [1] specifically calls out that HomeGallery “uses AI to power image and face discovery” as the distinguishing characteristic versus simpler alternatives like Lychee or Piwigo.

Privacy is the other angle. The README states the motivation plainly: “Cloud service do not cover my privacy concerns.” For founders and families who have grown uneasy about uploading children’s photos to Google’s servers, the local-AI approach matters. Every analysis runs on your hardware [README][1].

Versus PhotoPrism. PhotoPrism is the most direct competitor — both use AI classification, both are MIT-licensed, both target the “escape Google Photos” use case. PhotoPrism has 30x more GitHub stars and a commercial cloud tier. The practical difference: PhotoPrism is a more mature, multi-user system with enterprise aspirations and a paid tier; HomeGallery is a single-user project that intentionally stays focused. One reviewer [3] comparing self-hosted galleries spends most of its word count on PhotoPrism’s feature depth — which implicitly signals that HomeGallery trades breadth for simplicity.

Versus Immich. Immich has become the dominant recommendation in r/selfhosted for Google Photos replacement. It has an active mobile app, multi-user support, and a design that non-technical users can actually hand off to family members. HomeGallery doesn’t compete here — it doesn’t try to. The README explicitly scopes it to single-user use [README].

Versus Photoview and Piwigo. Photoview [1] is purpose-built for photographers, with RAW support and EXIF parsing — HomeGallery has no RAW processing. Piwigo [1][5] is multi-user and plugin-rich but doesn’t have AI-powered similarity search. Neither has HomeGallery’s face+similarity combo. The tradeoff is functionality depth in exchange for a narrower, more privacy-first use case.

---

Features

Based on the README and website:

Gallery and browsing:

• Endless photo stream via virtual scrolling — handles large archives without loading thousands of thumbnails at once [README]
• Preserves your existing folder structure — no import-and-reorganize step [README]
• Mobile-friendly interface and PWA support (installable on phone home screen) [README][4]
• Video transcoding and playback [README][4]
• REST API for integrating with other tools [4]

AI and search:

• Reverse image lookup (similar image search) — click one photo, find visually similar ones across your entire archive without any tagging [README]
• AI-powered image discovery by scene type: sunsets, food, buildings [README][website]
• Face recognition for identifying recurring people [README][website][1]
• Flexible search with a query language described as “fast as light” on the homepage
• Tag-based filtering with single and multi-image tagging [README][website]

Geo features:

• Reverse geocoding from GPS EXIF data — turns coordinates into readable addresses [README][website]
• Browse photos on a map by location history [website]

Deployment options:

• Prebuilt binaries for Linux, Mac, and Windows [README]
• Docker image and Docker Compose configs [README][4]
• App Bundle and Generic Bundle options for different environments [docs]
• NPM package [4]

What it doesn’t have:

• Multi-user support (single user only by explicit design) [README]
• RAW file processing
• Album sharing via public links (a feature Photoview and Lychee have)
• Managed cloud tier — there’s no “HomeGallery Cloud” option [README]

---

Pricing: SaaS vs self-hosted math

HomeGallery has no SaaS offering. It’s self-hosted only, MIT-licensed, free.

What you’re replacing and what you’d spend:

Service	Storage	Monthly cost
Google Photos	100 GB	$2.99/mo
Google Photos	2 TB	$9.99/mo
iCloud Photos	200 GB	$2.99/mo
Amazon Photos	Unlimited (without Prime)	$1.99/mo (100 GB)
HomeGallery	Your own disk	$0

Self-hosted running cost:

• If you already own a NAS (Synology, QNAP, TrueNAS): add $0 — run it on hardware you already pay for
• VPS on Hetzner or Contabo: $4–6/mo
• Raspberry Pi 4 (4GB): one-time ~$60, ongoing electricity
• Docker image handles the setup [README]

Concrete math for a typical family: 500GB of photos. Google Photos charges $2.99/mo (100GB tier is too small, so you’re on the 2TB plan at $9.99/mo). Annual cost: ~$120. HomeGallery self-hosted on a $6 Hetzner VPS with a mounted volume: $72/year — and you own the disk, not rent it. On a NAS you already have: $0/year ongoing.

The savings math is straightforward for anyone already paying Google or Apple. The real cost is setup time, which is where HomeGallery’s positioning becomes honest: it requires CLI comfort.

---

Deployment reality check

The README is clear about who this is for: “Computer affine users who solve their own problems and go the extra mile.” That’s not false modesty — it’s a genuine scope statement.

The quickstart on Linux is actually fast:

curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64 -o gallery
chmod 755 gallery
./gallery init --source ~/Pictures
./gallery run server

Point browser to localhost:3000 and you’re looking at your photos. For someone who’s comfortable in a terminal, this is legitimately a 5-minute deployment on Linux [README].

Docker Compose is available for more persistent setups, with configuration in gallery.config.yml [README][docs].

What complicates things:

• The documentation acknowledges that Linux/Debian is the “most tested platform” — Mac and Windows “run but are barely tested” [docs]. If you’re on Windows, budget for troubleshooting.
• The AI features (image similarity, face recognition) require processing time on first run. With a large photo archive (10,000+ photos), initial indexing can take hours depending on your hardware.
• Serving it publicly (with HTTPS, reverse proxy, domain) requires the usual nginx or Caddy setup that isn’t covered in the quickstart.
• The documentation mentions Azure deployment as an option but doesn’t provide detailed guides for most cloud providers.

Single-user constraint in practice: The README says “One user only — all files are served.” This isn’t a login-per-user system. If you want to share access with a spouse or parent, you’re sharing the same session — there’s no account separation [README]. For a personal NAS scenario this is fine; for anything else, it’s a hard stop.

Community support: Gitter and Discord are listed, but given the single-maintainer nature of the project, response times depend on the maintainer’s availability [README]. There’s no commercial support tier.

Realistic time estimate for a terminal-comfortable user: 15–30 minutes on Linux to a working local instance. Add HTTPS/domain: another hour. Mac or Windows: budget twice that with potential troubleshooting. Non-technical users: this is not the right tool [README][docs].

---

Pros and Cons

Pros

• MIT license. No restrictions, no commercial gates, no “fair-code” fine print. Fork it, modify it, run it forever [4].
• Reverse image search without tagging. The core AI feature works on arrival — point it at your photo folder and search by visual similarity with no manual work required [README][1].
• Face recognition. Find family members by face across an untagged archive [README][website][1].
• Preserves folder structure. Unlike some alternatives that import-and-reorganize, HomeGallery reads your existing directories. Your files stay where they are [README].
• Mobile-first PWA. Installable on a phone home screen, designed for mobile browsing — the README cites this as a primary motivation [README].
• Lightweight deployment options. Prebuilt single binaries for Linux/Mac/Windows mean no runtime dependencies to install separately [README].
• Geo browsing. GPS-tagged photos get reverse-geocoded to addresses and browsable on a map [README][website].
• Honest about scope. The maintainer explicitly warns it’s a spare-time project with no warranty. That honesty is itself a signal of trustworthiness [README].

Cons

• Single-user only. No multi-user accounts. If you need to give family members separate logins, look elsewhere (Immich, PhotoPrism) [README].
• Pet project risk. One maintainer, spare-time development, explicit “no warranty” disclaimer. If development stops, you maintain it yourself or migrate [README]. 1,099 GitHub stars means the community that would fork and maintain it in an emergency is small.
• CLI required. There’s no web-based installer. Setup requires terminal comfort. Non-technical users cannot self-deploy [README][docs].
• No RAW photo support. Photographers shooting RAW files should look at Photoview or PhotoPrism instead [1].
• No public album sharing. Can’t generate a shareable link for a set of photos to send to someone without server access [vs Lychee, Photoview].
• No SaaS escape hatch. If self-hosting becomes a burden, there’s no managed HomeGallery Cloud to migrate to. You migrate to a different tool entirely.
• Mac/Windows barely tested. Linux is the supported platform; everything else is best-effort [docs].
• No backup integration. No built-in sync to S3, Backblaze, or similar — you manage your own backup strategy for the underlying files.

---

Who should use this / who shouldn’t

Use HomeGallery if:

• You’re a single user who stores photos on a NAS or Linux server and wants a web interface over that existing folder structure.
• You want AI-powered similarity search and face recognition without paying for Google Photos or uploading to any cloud.
• You’re comfortable running terminal commands and can set up Docker or a Linux binary.
• You prioritize privacy to the point that you won’t accept any external processing of your images.
• You’re on Linux and want the fastest possible path from “folder of photos” to “searchable gallery.”

Skip it and use Immich if:

• You need multi-user accounts — spouse, parents, children each with separate logins.
• You want a mobile app that syncs photos automatically like Google Photos does.
• You want an active, well-staffed project with faster feature development.

Skip it and use PhotoPrism if:

• You need multi-user support with role management.
• You want a more mature AI classification pipeline with more categories.
• You’re comfortable paying for a managed cloud tier when self-hosting becomes inconvenient.

Skip it and use Photoview if:

• You shoot RAW files and need a gallery that handles EXIF-rich professional photography workflows.
• You want per-album sharing links.

Skip it entirely if:

• You’ve never used a terminal. This will be frustrating before it’s useful.
• You want to share the setup responsibility with a non-technical family member.
• You need guaranteed uptime, SLAs, or commercial support.

---

Alternatives worth considering

From the roundups and the self-hosted photo gallery landscape [1][2][4][5]:

• Immich — currently the most actively developed Google Photos replacement. Multi-user, mobile sync, machine learning-powered search. AGPL license. The community choice if you want rapid feature development.
• PhotoPrism — closer to HomeGallery in philosophy (AI discovery, folder-based, privacy-first) but multi-user, more mature, with a paid managed cloud option. MIT license on the community edition.
• Photoview — built for photographers, RAW support, EXIF parsing, per-album sharing. GPL-3.0. Lighter on AI features.
• LibrePhotos — Python-based, multi-user, face classification, semantic search. MIT license. More heavyweight to deploy.
• Lychee — lightweight, beautiful UI, MIT license, sharing-focused. Less AI, more traditional album management.
• Piwigo — mature, plugin-rich, multi-user, designed for organizations. GPL-2.0. No AI discovery.
• Pigallery2 — directory-first like HomeGallery, low-resource-optimized (runs well on Raspberry Pi). MIT license. No AI features.
• Jellyfin — not primarily a photo gallery but handles photos alongside video and music. GPL license. Worth considering if you’re already running it for media.

For a privacy-focused individual who wants AI search and is comfortable on Linux, the realistic shortlist is HomeGallery vs PhotoPrism. HomeGallery wins if you’re single-user and want a simpler, lower-maintenance setup. PhotoPrism wins if you need multi-user or want a larger community backing the project.

---

Bottom line

HomeGallery does a specific thing unusually well: it turns an existing folder of photos into a searchable, AI-indexed gallery without requiring you to send a single image outside your network. The reverse image search works on arrival, the face recognition is built in, the deployment is genuinely fast on Linux, and the MIT license means nobody can take it away or change the terms. The tradeoffs are equally real — single-user only, CLI-required, one-person project, no RAW support, no sharing features, and the maintainer has been explicit that this is spare-time work with no warranty. For a solo developer or founder with a NAS full of unorganized photos and a reasonable comfort level with Docker, the math is compelling: fifteen minutes of setup and you have a private, AI-searchable photo archive that costs nothing to run. If you need multi-user, a mobile sync app, or the ability to hand setup to a non-technical person, Immich or PhotoPrism are the right next stops.

---

Sources

1. Medevel — “17 Free Self-hosted Photo Gallery Solutions for Photographers, and Designers in 2024”. https://medevel.com/self-hosted-photo-gallery-1933/
2. Medevel — “Top 21 Favorite Self-hosted Photo Collection and Web-based Galleries [2024 Updated]”. https://medevel.com/os-photo-collection-self-hosted/
3. Medevel — “Create your own private Google Photo alternative with PhotoPrism”. https://medevel.com/photoprism/
4. The Homelab Wiki — “Awesome Selfhosted - Photo and Video Galleries”. https://thehomelab.wiki/books/helpful-tools-resources/page/awesome-selfhosted-photo-and-video-galleries
5. AlternativeTo — “Open Source Apps tagged with ‘Photo Organization’ for Windows”. https://alternativeto.net/category/phots-and-graphics/photo-management/?license=opensource&platform=windows

Primary sources:

• GitHub repository and README: https://github.com/xemle/home-gallery (1,099 stars, MIT license)
• Official website: https://home-gallery.org
• Documentation: https://home-gallery.org/docs/index.html
• Demo gallery: https://demo.home-gallery.org