https://github.com/dionysius/immich-deb
Ubuntu/Debian packages and repository for immich. Easy all-in-one and for advanced installations.
https://github.com/dionysius/immich-deb
debian debian-packages gpg immich packages repository ubuntu
Last synced: 17 days ago
JSON representation
Ubuntu/Debian packages and repository for immich. Easy all-in-one and for advanced installations.
- Host: GitHub
- URL: https://github.com/dionysius/immich-deb
- Owner: dionysius
- License: mit
- Created: 2025-11-26T16:27:04.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-05-18T13:57:35.000Z (25 days ago)
- Last Synced: 2026-05-18T15:34:30.237Z (25 days ago)
- Topics: debian, debian-packages, gpg, immich, packages, repository, ubuntu
- Homepage:
- Size: 259 MB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# immich deb packages
Easy to install and highly configurable debian packages for running [immich](https://github.com/immich-app/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.
## Installation
The easiest way to install immich is using the apt repository on [apt.crunchy.run/immich](https://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](https://github.com/dionysius/immich-deb/wiki/Installation).
Quick all-in-one installation:
```bash
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](https://github.com/dionysius/immich-deb/wiki/Installation) for additional requirements)_
Alternatively, download prebuilt packages from the [releases section](https://github.com/dionysius/immich-deb/releases) and verify signatures with the [signing-key](signing-key.pub). Packages are automatically built in [Github Actions](https://github.com/dionysius/immich-deb/actions).
## Configuration
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](https://github.com/dionysius/immich-deb/wiki/Configuration).
For advanced topics:
- [External Libraries](https://github.com/dionysius/immich-deb/wiki/External-Libraries) - Configure access to media outside the default directory
- [Hardware Acceleration](https://github.com/dionysius/immich-deb/wiki/Hardware-Acceleration) - GPU acceleration setup
See also the [Official Immich Documentation](https://docs.immich.app/) for user guides and features.
## Issues
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](https://docs.immich.app/overview/help) - For issues with immich
- [Issues](https://github.com/dionysius/immich-deb/issues) and [Discussions](https://github.com/dionysius/immich-deb/discussions) - For issues with or related to these packages
## Release schedule
This project aims to closely match the releases of upstream. The first release in each minor version series starts as a prerelease with a 3-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. Important releases may skip the waiting period.
## Build source package
This debian source package builds [immich](https://github.com/immich-app/immich) natively on your build environment. No annoying docker! It is managed with [git-buildpackage](https://wiki.debian.org/PackagingWithGit) and aims to be a pretty good quality debian source package. You can find the maintaining command summary in [debian/gbp.conf](debian/gbp.conf).
### Requirements
Installed `git-buildpackage` from your apt, clone with it and switch to the folder:
```bash
gbp clone https://github.com/dionysius/immich-deb.git
cd immich-deb
```
Installed build dependencies as defined in [debian/control `Build-Depends`](debian/control) (will notify you in the build process otherwise). [`mk-build-deps`](https://manpages.debian.org/testing/devscripts/mk-build-deps.1.en.html) can help you automate the installation, for example:
```bash
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](https://github.com/nodesource/distributions).
### Build package
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=` (before building the package export the source there), for example:
```bash
gbp buildpackage -b -us -uc
```
On successful build packages can now be found in the parent directory `ls ../*.deb`.
## Inspirations and Alternatives
- [immich-native script](https://github.com/arter97/immich-native)
- [immich-distribution snap](https://snapcraft.io/immich-distribution)
- [immich for Proxmox VE](https://community-scripts.org/scripts/immich)