Why does the home page with collections load slowly after idle time on a NAS?

This was a performance issue caused by unnecessary counting of files for each collection. The bug has been fixed in commit 591f814 (included in PR #115). Update to the latest version to resolve the slow loading.

Why does resizing the PhotoField window reset the view position?

This was a known regression that resets the view instead of anchoring the center photo during resize. It has been fixed in a subsequent update (see PR #123). Update to the latest version to resolve the issue.

How to change the default port 8080 for Photofield when another service is using it?

To change Photofield's default web interface port from 8080, use the environment variable PHOTOFIELD_SERVER_PORT when running in Docker. Example: `docker run -p 1200:1200 -e PHOTOFIELD_SERVER_PORT=1200 ...` (replace with your image name and other options). The `server.port` setting in `configuration.yaml` may not apply in all environments. For Docker, mapping the container port and setting the env var is the recommended approach. Ensure you also expose the same port with `-p` to avoid conflicts.

Photofield

SHA-256

576 stars·File Management·SHA-256 checksum verified

A self-hosted non-invasive single-binary photo gallery with a focus on speed and simplicity.

Smart Download

Download Download Version

v0.22.0 · 36.6 MB

Ultra-fast self-hosted photo gallery in a single binary, with seamless zoom, AI search, and blazing fast indexing.

Core Features

Seamless zoomable interface with progressive multi-resolution loading
Multiple layouts (Timeline, Flex, etc.)
Semantic search using AI (optional photofield-ai module)
Tagging (alpha) with arbitrary tags
Reverse geolocation with ~50k places database

What It Can't Do

•Not optimized for many concurrent users; server-side state leads to high resource usage under multiple clients,No user authentication/authorization; consider adding Basic Auth via reverse proxy,Slow initial load on cold HDD cache (generates layout and thumbnails for all photos),No permalinks; moving files or deleting cache breaks existing links

Use Cases

Browse huge photo collections locally with near-instant response
Replace Google Photos or Synology Photo Station with a faster, non-intrusive alternative
Use as a lightweight image layer for other apps (e.g., for photo review panels)

Photofield is a self-hosted photo viewer that prioritizes displaying a massive number of photos simultaneously with exceptional speed. Built with Go and Vue 3, it uses a single static binary for easy deployment. Key features include seamless zoomable interface, progressive multi-resolution loading (low-res preview to full quality), multiple layout options (Timeline, Flex, etc.), semantic search using AI, tagging (alpha), reverse geolocation, and a flexible media/thumbnail system (SQLite, FFmpeg, libjpeg-turbo). It operates non-intrusively—reads photo directories without modifying files—and can complement other gallery software. However, it is not optimized for many concurrent users, lacks user accounts, has slow initial load on cold caches, and does not support permanent URLs.

Getting Started

Download installer

Click the button above to download the installer for your system

Windows· 36.6 MB Linux· 35.1 MB

Install the software

Double-click the downloaded installer and follow the prompts

Step 1: Download the latest binary (or use Docker image)

Step 2: Create 'data/' directory for cache and put your photos in 'photos/'

Step 3: Run `./photofield` (or Docker), open http://localhost:8080

Install Guide

Step 1: Download the latest binary (or use Docker image)
Step 2: Create 'data/' directory for cache and put your photos in 'photos/'
Step 3: Run `./photofield` (or Docker), open http://localhost:8080

File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

61a812db88df6b2b3b7e3455fcce20c26d7a8ee7f5e95f5a9a2180ec149d956d

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source

Environment Guide

Uninstall Info

Delete the data directory and the binary. For Docker, run `docker rm photofield` and remove mounted volumes.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info

LicenseMIT

Last Updated2026-06-26 15:00:28

GitHub Repository Official Website

Having issues? Check the FAQ below

3 FAQs

Similar Projects

copyparty

copyparty turns any device into a file server with resumable uploads/downloads using any web browser. Supports HTTP, WebDAV, SFTP, FTP, TFTP, SMB. Only requires Python (2 or 3).

Paperless-ngx

An open-source document management system that turns physical papers into a searchable, organized digital archive. Self-hosted, OCR-powered, and built to eliminate paper clutter forever.

Nextcloud Server

Nextcloud Server is a free, self-hosted productivity platform that puts you in control of your files, contacts, calendars, and communication.