Immich - Self-Hosted Photo Gallery
Photo and video gallery with AI-powered face recognition, object detection and semantic search. Alternative to Google Photos.
Access
Architecture
| Component |
Purpose |
immich-server |
Main backend (API, UI) |
immich-postgres |
PostgreSQL 14 + vectorchord (ML vectors) |
immich-redis |
Session cache and job queue |
immich-machine-learning |
AI (CLIP embeddings, face recognition buffalo_l) |
Storage
| Path |
Contents |
/media/seagata16t/immich/ |
Photos and videos |
./immich/model-cache/ |
ML model cache |
./immich/postgres/ |
Database files |
Resource Limits
| Component |
Limit |
immich-server |
6 GB RAM |
immich-machine-learning |
2 CPU, 3 GB RAM |
Notes
- Dedicated PostgreSQL instance (
immich_postgres) - separate from the shared postgres18
- Dedicated Redis (
immich_redis) - not shared with other services
- ML runs on CPU only (no GPU passthrough)
Useful Commands
# Follow logs
docker logs immich_server -f
docker logs immich_machine_learning -f
# Restart
docker compose restart immich-server immich-machine-learning
# Check library size
du -sh /media/seagata16t/immich/