Easy to install and highly configurable debian packages for running immich on your system natively without docker. It supports a simple all-in-one package as well as that any server componenent can be installed separately. Out of the box it can be installed and built on Debian stable and latest Ubuntu LTS.
The easiest way to install immich is using the apt repository on apt.crunchy.run/immich. Installation instructions are available directly on the repository page.
For detailed installation guides, including basic and advanced setup options, see the Installation Wiki.
Quick all-in-one installation:
sudo apt install curl
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -
curl -fsSL https://apt.crunchy.run/immich/install.sh | sudo bash -
sudo apt install immich(For dependency errors, see the Installation Wiki for additional requirements)
Alternatively, download prebuilt packages from the releases section and verify signatures with the signing-key. Packages are automatically built in Github Actions.
After installation, you'll need to configure the services. For complete setup instructions including database configuration, network settings, and service management, see the Configuration Wiki.
For advanced topics:
- External Libraries - Configure access to media outside the default directory
- Hardware Acceleration - GPU acceleration setup
See also the Official Immich Documentation for user guides and features.
As this package provides an alternative installation method, there may be differences from the official Docker images. Please verify any problems are also reproducible with their official Docker images before reporting upstream.
- Official Help Page - For issues with immich
- Issues and Discussions - For issues with or related to these packages
This project aims to closely match the releases of upstream. The first release in each minor version series starts as a prerelease with a 7-day waiting period to allow upstream to fix oversights in new features or changes. Subsequent releases follow the same waiting period. After the waiting period has passed, all prereleases are automatically promoted to normal releases including new releases.
This debian source package builds immich natively on your build environment. No annoying docker! It is managed with git-buildpackage and aims to be a pretty good quality debian source package. You can find the maintaining command summary in debian/gbp.conf.
Installed git-buildpackage from your apt, clone with it and switch to the folder:
gbp clone https://github.com/dionysius/immich-deb.git
cd immich-debInstalled build dependencies as defined in debian/control Build-Depends (will notify you in the build process otherwise). mk-build-deps can help you automate the installation, for example:
mk-build-deps -i -r debian/control -t "apt-get -o Debug::pkgProblemResolver=yes --no-install-recommends --yes"If nodejs/npm is not recent enough don't forget to look into your *-updates/*-backports apt sources for newer versions or use a package from nodesource.
There are many arguments to fine-tune the build (see gbp buildpackage --help and dpkg-buildpackage --help), notable options: -b (binary-only, no source files), -us (unsigned source package), -uc (unsigned .buildinfo and .changes file), --git-export-dir=<somedir> (before building the package export the source there), for example:
gbp buildpackage -b -us -ucOn successful build packages can now be found in the parent directory ls ../*.deb.
