| Port details |
- immich High performance self-hosted photo and video management solution
- 3.1.0_1 www
 =0      Package not present on quarterly.This port was created during this quarter. It will be in the next quarterly branch but not the current one. - Maintainer: joneum@FreeBSD.org
- Port Added: 2026-08-16 18:06:13
- Last Update: 2026-08-25 04:27:12
- Commit Hash: 5bfc1e0
- License: AGPLv3
- WWW:
- https://immich.app/
- Description:
- Immich is a high performance self-hosted photo and video management
solution. It is designed as a privacy-friendly replacement for cloud
photo services and offers automatic mobile backup (iOS/Android apps),
a fast web interface, albums, sharing, timeline and map views,
duplicate detection, smart search and facial recognition.
This port contains the Immich server including the bundled web
frontend. It requires a PostgreSQL database with the pgvector and
vchord extensions and a Redis-compatible cache such as valkey.
Smart search, duplicate detection and facial recognition
additionally require the machine-learning service from
www/immich-ml.
  ¦  ¦  ¦  ¦ 
- Manual pages:
- FreshPorts has no man page information for this port.
- pkg-plist: as obtained via:
make generate-plist - USE_RC_SUBR (Service Scripts)
-
- Dependency lines:
-
- To install the port:
- cd /usr/ports/www/immich/ && make install clean
- To add the package, run one of these commands:
- pkg install www/immich
- pkg install immich
NOTE: If this package has multiple flavors (see below), then use one of them instead of the name specified above.- PKGNAME: immich
- Flavors: there is no flavor information for this port.
- ONLY_FOR_ARCHS: aarch64 amd64
- distinfo:
- TIMESTAMP = 1786867736
SHA256 (immich-freebsd-buildkit-3.1.0.tar.gz) = c04c9055198152d150fd0417151f090232664978fa7b0ae76d15f1a6d17e4d70
SIZE (immich-freebsd-buildkit-3.1.0.tar.gz) = 367404006
Packages (timestamps in pop-ups are UTC):
- Dependencies
- NOTE: FreshPorts displays only information on required and default dependencies. Optional dependencies are not covered.
- Build dependencies:
-
- npm-node22>0 : www/npm-node22
- gmake>=4.4.1 : devel/gmake
- node : www/node22
- psql : databases/postgresql18-client
- pkgconf>=1.3.0_1 : devel/pkgconf
- python3.12 : lang/python312
- Runtime dependencies:
-
- exiftool : graphics/p5-Image-ExifTool
- ffmpeg : multimedia/ffmpeg
- node : www/node22
- psql : databases/postgresql18-client
- Library dependencies:
-
- libheif.so : graphics/libheif
- libraw.so : graphics/libraw
- libvips.so : graphics/vips
- There are no ports dependent upon this port
Configuration Options:- No options to configure
- Options name:
- www_immich
- USES:
- gmake nodejs:22,build,run pgsql:14+ pkgconfig python:build
- pkg-message:
- For install:
- Immich server was installed.
Requirements:
* PostgreSQL with the extensions pgvector and vchord, e.g.:
pkg install postgresql18-server postgresql18-contrib \
postgresql18-pgvector postgresql18-vchord
* Redis-compatible cache, e.g.:
pkg install valkey && sysrc valkey_enable=YES
Configuration:
1. VectorChord must be preloaded. Add to postgresql.conf:
shared_preload_libraries = 'vchord.so'
and restart PostgreSQL.
2. Create a database and user for immich, then create the
extensions as superuser in that database:
CREATE EXTENSION vector;
CREATE EXTENSION vchord CASCADE;
CREATE EXTENSION cube;
CREATE EXTENSION earthdistance;
CREATE EXTENSION pg_trgm;
The immich role needs superuser during schema migrations,
or pre-create the extensions as shown above.
3. Put the connection settings into %%PREFIX%%/etc/immich.env:
DB_HOSTNAME=localhost
DB_USERNAME=immich
DB_PASSWORD=secret
DB_DATABASE_NAME=immich
REDIS_HOSTNAME=localhost
4. Enable and start the service:
sysrc immich_server_enable=YES
service immich_server start
5. Optional: install www/immich-ml for smart search, duplicate
detection and facial recognition, then set the machine-learning
URL in the admin web UI (Administration > Settings >
Machine Learning) to http://127.0.0.1:3003
The web interface listens on port 2283 by default. The upload
location defaults to /var/db/immich and can be changed with
sysrc immich_server_media_location=/path.
- Master Sites:
|
| Commit History - (may be incomplete: for full details, see links to repositories near top of page) |
| Commit | Credits | Log message |
|---|
3.1.0_1
25 Aug 2026 04:27:12
 |
Jochen Neumeister (joneum) |
www/immich: Fix the built-in database backup
immich looks for pg_dump in a path that does not exist, and the port did not
depend on a PostgreSQL client at all. The nightly backup job therefore failed
with ENOENT on every installation while the web interface reported the feature
as enabled. The version range follows the check in the service itself,
PostgreSQL 14 to 18.
Sponsored by: Netzkommune GmbH |
3.1.0
16 Aug 2026 18:03:16
|
Jochen Neumeister (joneum) |
www/immich: Add New Port
High performance self-hosted photo and video management solution.
This port contains the Immich server including the bundled web
frontend, built natively with node22/pnpm against the system
libvips. Requires PostgreSQL with the pgvector and vchord
extensions and a Redis-compatible cache such as valkey. Smart
search, duplicate detection and facial recognition additionally
require the machine-learning service from www/immich-ml.
WWW: https://immich.app/
Sponsored by: Netzkommune GmbH |
As an Amazon Associate I earn from qualifying purchases.