Sistema completo di gestione foto e video con AI/ML.
Container: immich_server
Image: ghcr.io/immich-app/immich-server:release
Version: release (latest)
Location: LXC 100 (docker-server)
Port: 2283
Storage Used: ~83 GB
Status: ✅ Running (healthy)
Local: http://192.168.178.100:2283
External: https://immich.leonardobrentegani.casa (da configurare)
Email: [DA CONFIGURARE - primo accesso]
Password: [DA CONFIGURARE - primo accesso]
Note: Se non hai mai fatto login, crea primo utente admin
Services:
immich_server:
- Main application server
- Port: 2283
- Image: ghcr.io/immich-app/immich-server:release
immich_machine_learning:
- AI/ML processing (face recognition, object detection)
- No external ports
- Image: ghcr.io/immich-app/immich-machine-learning:release
immich_postgres:
- PostgreSQL 14 database with pgvector extension
- Port: 5432 (internal)
- Image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0
immich_redis:
- Cache and job queue
- Port: 6379 (internal)
- Image: valkey/valkey:8
Host: docker-server (LXC 100)
Compose File: /root/immich-app/docker-compose.yml
Data Path: ./immich/library
DB Path: ./postgres
Config: .env file
# Database
DB_USERNAME=postgres
DB_PASSWORD=postgres
DB_DATABASE_NAME=immich
# Storage
UPLOAD_LOCATION=./immich/library
DB_DATA_LOCATION=./postgres
# Version
IMMICH_VERSION=release
# Features
IMMICH_FS_WATCH=true
IMMICH_WEBP_ENABLED=true
# Typesense (search)
TYPESENSE_API_KEY=immich_typesense_xyz_secret
Version: 14 with pgvector and vectorchord
Host: immich_postgres
Port: 5432
Database: immich
User: postgres
Password: postgres
Extensions:
- pgvector → Vector similarity search
- vectorchord → Optimized vector operations
# Enter docker-server
pct enter 100
# Backup
cd /root/immich-app
docker compose exec immich_postgres pg_dump -U postgres immich > immich-backup-$(date +%Y%m%d).sql
# Compress
gzip immich-backup-$(date +%Y%m%d).sql
# Location
ls -lh immich-backup-*.sql.gz
# Stop Immich
cd /root/immich-app
docker compose stop immich_server
# Restore
cat immich-backup-YYYYMMDD.sql | docker compose exec -T immich_postgres psql -U postgres immich
# Start Immich
docker compose start immich_server
Total Storage: ~83 GB
Location: /root/immich-app/immich/library/
Breakdown:
- Photos: [estimate %]
- Videos: [estimate %]
- Thumbnails: [automatic]
- ML Models: [cached]
# Inside docker-server
/root/immich-app/
├── docker-compose.yml
├── .env
├── immich/
│ └── library/ # Photos & videos
│ ├── upload/
│ ├── thumbs/
│ └── encoded-video/
└── postgres/ # Database files
# If needed, expand LXC disk from Proxmox
# Currently: 150 GB allocated, 83 GB used
# From Proxmox:
# VM/LXC 100 → Hardware → Hard Disk → Resize
# Add +50 GB (or desired amount)
# Then inside LXC (Alpine):
resize2fs /dev/mapper/... # or appropriate command
✅ Mobile app sync (iOS/Android)
✅ AI face recognition
✅ Object detection
✅ Smart search
✅ Photo timeline
✅ Albums & sharing
✅ Video transcoding
✅ RAW photo support
✅ Live photos
✅ Multi-user
✅ External library import
Face Detection: buffalo_l
Object Detection: yolov8n
CLIP (search): ViT-B-32
Model Cache: Docker volume (immich_model-cache)
# Enter docker-server
pct enter 100
# Navigate to compose directory
cd /root/immich-app
# Stop
docker compose stop
# Start
docker compose start
# Restart
docker compose restart
# Full restart with pull
docker compose down
docker compose pull
docker compose up -d
cd /root/immich-app
# All services
docker compose logs -f
# Specific service
docker compose logs -f immich_server
docker compose logs -f immich_machine_learning
docker compose logs -f immich_postgres
cd /root/immich-app
# Stop services
docker compose down
# Pull new images
docker compose pull
# Start with new version
docker compose up -d
# Check logs
docker compose logs -f
# Enter postgres container
cd /root/immich-app
docker compose exec immich_postgres psql -U postgres immich
# Check database size
SELECT pg_size_pretty(pg_database_size('immich'));
# Vacuum
VACUUM ANALYZE;
# Exit
\q
# Via Immich UI:
# Settings → Jobs → Thumbnail Generation → Run All
# Stop ML container
docker compose stop immich_machine_learning
# Remove model cache (will re-download)
docker volume rm immich_model-cache
# Start ML container
docker compose start immich_machine_learning
Server URL: https://immich.leonardobrentegani.casa
(or http://192.168.178.100:2283 on LAN)
Login: [Your configured email/password]
Features:
- Auto backup photos/videos
- Background upload
- Album sync
- Offline photo viewing
iOS: App Store → "Immich"
Android: Google Play → "Immich"
Requirement: iOS 15+ / Android 8+
Essential:
1. Database (PostgreSQL dump)
2. Photos/Videos (./immich/library/)
3. Configuration (.env, docker-compose.yml)
Optional:
4. Thumbnails (can regenerate)
5. ML cache (can re-download)
#!/bin/bash
# Immich full backup script
BACKUP_DIR="/mnt/nas-backup/immich"
DATE=$(date +%Y%m%d)
# Create backup directory
mkdir -p $BACKUP_DIR
# Backup database
cd /root/immich-app
docker compose exec -T immich_postgres pg_dump -U postgres immich | gzip > $BACKUP_DIR/immich-db-$DATE.sql.gz
# Backup photos (rsync)
rsync -av --progress /root/immich-app/immich/library/ $BACKUP_DIR/library/
# Backup config
cp /root/immich-app/.env $BACKUP_DIR/env-$DATE.bak
cp /root/immich-app/docker-compose.yml $BACKUP_DIR/compose-$DATE.bak
echo "Backup completed: $BACKUP_DIR"
# Check container status
docker compose ps
# If not healthy, check logs
docker compose logs immich_server
# Common fixes:
# 1. Restart
docker compose restart immich_server
# 2. Check database connection
docker compose exec immich_server ping immich_postgres
# 3. Verify environment
docker compose exec immich_server env | grep DB_
# Check ML container
docker compose logs immich_machine_learning
# Restart ML service
docker compose restart immich_machine_learning
# Check if models are downloaded
docker compose exec immich_machine_learning ls -lh /cache/
# Check disk space
df -h
# Check permissions
ls -la /root/immich-app/immich/library/
# Check server logs
docker compose logs -f immich_server | grep -i upload
# Check Postgres status
docker compose exec immich_postgres pg_isready -U postgres
# Check database connections
docker compose exec immich_postgres psql -U postgres -c "SELECT count(*) FROM pg_stat_activity;"
# Restart database (careful!)
docker compose restart immich_postgres
✅ LXC has 4 CPU cores (good for ML)
✅ 4GB RAM (adequate for small library)
✅ SSD storage (fast I/O)
Consider increasing:
- RAM to 6-8GB if ML is slow
- CPU to 6 cores for faster face detection
Via Immich UI:
Settings → Video Transcoding
Recommended:
- Codec: H.264
- Quality: Medium
- Hardware acceleration: None (no GPU in LXC)
# Access docker-server
pct enter 100
# Navigate to Immich
cd /root/immich-app
# View status
docker compose ps
# Logs
docker compose logs -f immich_server
# Restart
docker compose restart
# Update
docker compose pull && docker compose up -d
# Backup DB
docker compose exec immich_postgres pg_dump -U postgres immich > backup.sql
Documentation: https://immich.app/docs
GitHub: https://github.com/immich-app/immich
Discord: https://discord.gg/immich
Last Updated: 15 November 2025
Version: release (check UI for exact version)
Status: ✅ Running
Storage: 83 GB / 150 GB available