Hướng dẫn cài đặt Immich – phần mềm quản lý ảnh cá nhân tương tự google photos trên Ubuntu Server

# Cập nhật hệ thống
sudo apt update && sudo apt upgrade -y

# Cài Docker và Docker Compose
sudo apt install -y docker.io docker-compose-plugin

# Khởi động Docker
sudo systemctl enable --now docker

# Thêm user vào docker group (để chạy không cần sudo)
sudo usermod -aG docker $USER

# Đăng xuất và đăng nhập lại để áp dụng, hoặc chạy:
newgrp docker

# Kiểm tra cài đặt
docker --version
docker compose version

# Tạo thư mục cho Immich
sudo mkdir -p /opt/immich
cd /opt/immich

# Tải file docker-compose.yml và .env từ bản phát hành mới nhất
sudo wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
sudo wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

# Tạo thư mục lưu trữ ảnh
sudo mkdir -p /var/lib/immich/{upload,thumbs,encoded-video,profile}
sudo chown -R 1000:1000 /var/lib/immich

sudo nano /opt/immich/.env

# Đường dẫn lưu ảnh upload
UPLOAD_LOCATION=/var/lib/immich/upload

# Mật khẩu PostgreSQL (quan trọng - thay bằng mật khẩu mạnh)
DB_PASSWORD=ThayBangMatKhauManhCuaBan

# Múi giờ (bỏ dấu # và sửa)
TZ=Asia/Ho_Chi_Minh

# Phiên bản Immich (để "release" để dùng bản mới nhất)
IMMICH_VERSION=release

# Mở file docker-compose.yml
sudo nano /opt/immich/docker-compose.yml

services:
  immich-server:
    # ... các cấu hình khác giữ nguyên ...
    volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      # THÊM DÒNG NÀY - đường dẫn đến thư mục ảnh đã có
      - /home/huannv/Data/ANH_CHUP_PROCESSED/Images:/mnt/existing-photos:ro
      - /etc/localtime:/etc/localtime:ro

  immich-microservices:
    # ... các cấu hình khác giữ nguyên ...
    volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      # THÊM DÒNG NÀY - giống như trên
      - /home/huannv/Data/ANH_CHUP_PROCESSED/Images:/mnt/existing-photos:ro
      - /etc/localtime:/etc/localtime:ro

cd /opt/immich

# Khởi động tất cả container
docker compose up -d

# Kiểm tra trạng thái
docker compose ps

# Xem log (nếu cần)
docker compose logs -f

# Giảm số worker để tránh quá tải
# Mở file docker-compose.yml, thêm vào service immich-server và immich-microservices:
environment:
  - MACHINE_LEARNING_WORKERS=2
  - MACHINE_LEARNING_REQUEST_THREADS=4

# Tăng worker để tận dụng đa luồng
environment:
  - MACHINE_LEARNING_WORKERS=6
  - MACHINE_LEARNING_REQUEST_THREADS=12

# Không nên port-forward cổng 2283 [citation:2]
# Sử dụng VPN (WireGuard) hoặc Cloudflare Tunnel để truy cập từ xa

# Tạo script backup
cat > /opt/immich/backup.sh << 'EOF'
#!/bin/bash
BACKUP_DIR="/backup/immich"
DATE=$(date +%Y%m%d-%H%M)
mkdir -p "$BACKUP_DIR"

# Backup database
docker compose -f /opt/immich/docker-compose.yml exec -T database \
  pg_dumpall -U postgres | gzip > "$BACKUP_DIR/immich-db-${DATE}.sql.gz"

# Backup photos (nếu cần)
rsync -av --delete /var/lib/immich/upload/ /backup/immich/photos/

# Xóa backup cũ hơn 30 ngày
find "$BACKUP_DIR" -name "*.sql.gz" -mtime +30 -delete
EOF

chmod +x /opt/immich/backup.sh

# Thêm vào crontab (chạy lúc 3h sáng)
echo "0 3 * * * root /opt/immich/backup.sh >> /var/log/immich-backup.log 2>&1" | \
  sudo tee /etc/cron.d/immich-backup

/opt/immich/
├── docker-compose.yml
├── .env
└── (các file cấu hình khác)

/var/lib/immich/
├── upload/           # Ảnh upload từ mobile/web
├── thumbs/           # Ảnh thumbnail
├── encoded-video/    # Video đã transcoded
└── profile/          # Ảnh đại diện user

/home/huannv/Data/ANH_CHUP_PROCESSED/Images/  # External library (read-only)