Immich
vrelease
Self-hosted photo and video backup solution with mobile app
What's included
- Immich (latest release, fully configured)
- Caddy web server with auto-HTTPS
- PostgreSQL with pgvecto-rs (ML vector search)
- Redis for caching
- Machine learning service (face/object recognition)
- Docker Compose managed
After install
- Login with the admin credentials shown at install
- No signup page exposed to the internet
- Install the Immich mobile app and point it at your server
- Custom domain: IMMICH_HOST=photos.example.com
- Upgrade: cd /opt/immich && docker compose pull && docker compose up -d
How the install works
Generated from the install script itself -- these are the exact phases it runs on your server.
- 1.Pre-flight checks
- 2.Creating swap
- 3.Opening firewall
- 4.Installing system dependencies
- 5.Installing Docker
- 6.Installing Caddy
- 7.Setting up Immich
- 8.Starting Immich
- 9.Creating admin account
- 10.Configuring Caddy
Supported Operating Systems
Ubuntu 24Ubuntu 25Debian 12Debian 13Rocky 9Rocky 10Alma 9Alma 10
Requirements
- RAM
- 4GB minimum
- Disk
- 20GB minimum
Configuration
| Variable | Default | Description |
|---|---|---|
| IMMICH_HOST | server hostname | Domain name or IP. Domains get auto-HTTPS via Let's Encrypt. |
| IMMICH_ADMIN_EMAIL | admin@hostname | Admin account email |
| IMMICH_ADMIN_PASS | random 24-char | Admin account password |
| IMMICH_DB_PASS | random 24-char | PostgreSQL password |
| IMMICH_UPLOAD_DIR | /var/lib/immich/upload | Directory for photo and video storage |
27 installsOfficial website →
Changelog
v1.0.12026-07-12
- Port 2283 bound to loopback (Docker published it past the firewall and Caddy)
- /opt/immich/.env restricted to 0600, state directories to 0750
- Reliable Caddy config load (restart instead of enable --now)
v1.0.02026-04-02
- Initial release with Docker Compose (official upstream method)
- Caddy reverse proxy with auto-HTTPS
- PostgreSQL + Redis + ML service included
- Configurable upload directory