| Port details |
- immich High performance self-hosted photo and video management solution
- 3.1.0 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-16 18:03:16
- Commit Hash: 7cf929a4
- 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
- pkgconf>=1.3.0_1 : devel/pkgconf
- python3.12 : lang/python312
- Runtime dependencies:
-
- exiftool : graphics/p5-Image-ExifTool
- ffmpeg : multimedia/ffmpeg
- node : www/node22
- 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 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:
|