tonym/NastyNAS
1
0
Fork 0
Code Issues 70 Pull Requests Actions Packages Projects Releases Wiki Activity

Configure Immich Photo Management #35

New Issue
Open
opened 2025-09-14 08:10:18 +00:00 by tonym · 0 comments
tonym commented 2025-09-14 08:10:18 +00:00
Owner
Copy Link

Immich Photo Management Configuration for Unraid 7.0.1

Container Installation

  • From Community Applications: Search "Immich"
  • Container Selection: Immich-App (multi-container setup)
  • Repository: ghcr.io/immich-app/immich-server:latest

Container Configuration

Immich Server Settings:

  • Container Port: 3001
  • Host Port: 3001
  • Network Mode: bridge
  • Repository Path: ghcr.io/immich-app/immich-server:latest

Volume Mappings:

  • Upload: /mnt/user/appdata/immich/upload:/usr/src/app/upload
  • Photos: /mnt/user/Photos:/mnt/media/photos:ro
  • Videos: /mnt/user/Videos:/mnt/media/videos:ro
  • Config: /mnt/user/appdata/immich/config:/config

Environment Variables:

  • PUID: 99
  • PGID: 100
  • TZ: America/Chicago
  • UMASK: 002
  • DB_HOSTNAME: postgresql-immich
  • DB_USERNAME: immich
  • DB_PASSWORD: (generate secure password)
  • DB_DATABASE_NAME: immich
  • REDIS_HOSTNAME: redis
  • REDIS_PORT: 6379
  • MACHINE_LEARNING_ENABLED: true
  • MACHINE_LEARNING_URL: http://immich-machine-learning:3003

Additional Containers Required

PostgreSQL Database:

  • Container: postgresql (see issue #61)
  • Database: immich
  • User: immich
  • Password: (secure password)

Redis Cache:

  • Container: redis (see issue #88)
  • Port: 6379
  • Configuration: Default settings

Machine Learning (Optional):

  • Container: ghcr.io/immich-app/immich-machine-learning:latest
  • Port: 3003
  • GPU Support: Enable if available

Initial Configuration

  1. First Access: http://[SERVER_IP]:3001
  2. Admin Setup:
    • Create admin account
    • Set strong password
    • Configure email settings
  3. Library Setup:
    • Add photo libraries
    • Configure scan settings
    • Set up face recognition

Service Configuration

Library Management:

  • External Libraries: /mnt/media/photos, /mnt/media/videos
  • Upload Directory: /usr/src/app/upload
  • Scan Schedule: Daily incremental, weekly full
  • File Types: RAW, JPEG, HEIC, MP4, MOV support

Machine Learning Features:

  • Face Recognition: Enable for person tagging
  • Object Detection: Enable for smart search
  • CLIP Search: Enable semantic search
  • Smart Search: Natural language queries

Storage Settings:

  • Thumbnail Generation: High quality
  • Video Transcoding: Hardware acceleration if available
  • Storage Template: Organize by date/camera
  • Duplicate Detection: Enable duplicate handling

Integration Points

Mobile Apps:

  • iOS App: Available on App Store
  • Android App: Available on Google Play
  • Auto-upload: Configure mobile backup
  • Background Sync: Enable for continuous backup

External Storage:

  • Network Shares: Mount additional photo sources
  • Cloud Import: Configure cloud service imports
  • External Drives: Add USB/external storage

Monitoring & Notifications

Uptime Kuma Integration:

Performance Monitoring:

  • Database Performance: Monitor PostgreSQL
  • Redis Performance: Monitor cache hit rates
  • ML Processing: Monitor GPU/CPU usage
  • Storage Usage: Monitor disk space

Backup Configuration

Kopia Integration:

  • Backup Paths:
    • /mnt/user/appdata/immich (configuration)
    • PostgreSQL database dumps
    • Thumbnail cache (optional)
  • Schedule: Daily at 1:00 AM
  • Retention: 30 daily, 12 monthly

Database Backups:

  • pg_dump: Daily database exports
  • Incremental: Use PostgreSQL WAL archiving
  • Testing: Regular restore testing

Testing Procedures

Health Checks:

  1. Container Status: docker ps | grep immich
  2. Database Connection: Test PostgreSQL connectivity
  3. Redis Connection: Test cache connectivity
  4. Web Interface: Access via browser

Functionality Tests:

  1. Photo Upload: Test manual upload
  2. Library Scan: Test automatic detection
  3. Face Recognition: Test person tagging
  4. Search Function: Test smart search
  5. Mobile Sync: Test mobile app connection

Performance Tests:

  1. Upload Speed: Test large file uploads
  2. Thumbnail Generation: Test processing speed
  3. Search Response: Test query performance
  4. Mobile Sync: Test backup speed

Troubleshooting

Common Issues:

  1. Database Connection Failed:

    • Verify PostgreSQL is running
    • Check database credentials
    • Validate network connectivity
    • Review PostgreSQL logs

  2. Machine Learning Not Working:

    • Check ML container status
    • Verify GPU drivers if using GPU
    • Monitor resource usage
    • Review ML container logs

  3. Slow Performance:

    • Check database performance
    • Monitor Redis cache hit rates
    • Verify storage I/O performance
    • Review thumbnail generation settings

  4. Mobile App Issues:

    • Verify server accessibility
    • Check SSL certificate if using HTTPS
    • Validate mobile app credentials
    • Review server logs for authentication errors

Permission Fixes:

sudo chown -R 99:100 /mnt/user/appdata/immich
sudo chmod -R 755 /mnt/user/appdata/immich
sudo chown -R 99:100 /mnt/user/Photos
sudo chmod -R 755 /mnt/user/Photos

Log Locations:

  • Container Logs: docker logs immich-server
  • Application Logs: /mnt/user/appdata/immich/logs
  • Database Logs: PostgreSQL container logs
  • ML Logs: Machine learning container logs

Maintenance

Regular Tasks:

  1. Library Maintenance: Monthly library scans
  2. Database Maintenance: Weekly VACUUM and ANALYZE
  3. Thumbnail Cleanup: Remove orphaned thumbnails
  4. Log Rotation: Manage log file sizes
  5. Security Updates: Update containers regularly

Performance Optimization:

  1. Database Tuning: Optimize PostgreSQL settings
  2. Redis Configuration: Tune cache settings
  3. Storage Optimization: Monitor and optimize storage
  4. Hardware Acceleration: Enable GPU processing if available

Storage Management:

  1. Disk Usage: Monitor photo storage growth
  2. Cleanup Tasks: Remove duplicate files
  3. Archive Strategy: Plan for long-term storage
  4. Backup Verification: Regularly test backup integrity
# Immich Photo Management Configuration for Unraid 7.0.1 ## Container Installation - **From Community Applications:** Search "Immich" - **Container Selection:** Immich-App (multi-container setup) - **Repository:** ghcr.io/immich-app/immich-server:latest ## Container Configuration **Immich Server Settings:** - **Container Port:** 3001 - **Host Port:** 3001 - **Network Mode:** bridge - **Repository Path:** ghcr.io/immich-app/immich-server:latest **Volume Mappings:** - **Upload:** /mnt/user/appdata/immich/upload:/usr/src/app/upload - **Photos:** /mnt/user/Photos:/mnt/media/photos:ro - **Videos:** /mnt/user/Videos:/mnt/media/videos:ro - **Config:** /mnt/user/appdata/immich/config:/config **Environment Variables:** - **PUID:** 99 - **PGID:** 100 - **TZ:** America/Chicago - **UMASK:** 002 - **DB_HOSTNAME:** postgresql-immich - **DB_USERNAME:** immich - **DB_PASSWORD:** (generate secure password) - **DB_DATABASE_NAME:** immich - **REDIS_HOSTNAME:** redis - **REDIS_PORT:** 6379 - **MACHINE_LEARNING_ENABLED:** true - **MACHINE_LEARNING_URL:** http://immich-machine-learning:3003 ## Additional Containers Required **PostgreSQL Database:** - **Container:** postgresql (see issue #61) - **Database:** immich - **User:** immich - **Password:** (secure password) **Redis Cache:** - **Container:** redis (see issue #88) - **Port:** 6379 - **Configuration:** Default settings **Machine Learning (Optional):** - **Container:** ghcr.io/immich-app/immich-machine-learning:latest - **Port:** 3003 - **GPU Support:** Enable if available ## Initial Configuration 1. **First Access:** http://[SERVER_IP]:3001 2. **Admin Setup:** - Create admin account - Set strong password - Configure email settings 3. **Library Setup:** - Add photo libraries - Configure scan settings - Set up face recognition ## Service Configuration **Library Management:** - **External Libraries:** /mnt/media/photos, /mnt/media/videos - **Upload Directory:** /usr/src/app/upload - **Scan Schedule:** Daily incremental, weekly full - **File Types:** RAW, JPEG, HEIC, MP4, MOV support **Machine Learning Features:** - **Face Recognition:** Enable for person tagging - **Object Detection:** Enable for smart search - **CLIP Search:** Enable semantic search - **Smart Search:** Natural language queries **Storage Settings:** - **Thumbnail Generation:** High quality - **Video Transcoding:** Hardware acceleration if available - **Storage Template:** Organize by date/camera - **Duplicate Detection:** Enable duplicate handling ## Integration Points **Mobile Apps:** - **iOS App:** Available on App Store - **Android App:** Available on Google Play - **Auto-upload:** Configure mobile backup - **Background Sync:** Enable for continuous backup **External Storage:** - **Network Shares:** Mount additional photo sources - **Cloud Import:** Configure cloud service imports - **External Drives:** Add USB/external storage ## Monitoring & Notifications **Uptime Kuma Integration:** - **Monitor Type:** HTTP - **URL:** http://[SERVER_IP]:3001/api/server-info/ping - **Check Interval:** 60 seconds - **Alert Threshold:** 3 failures **Performance Monitoring:** - **Database Performance:** Monitor PostgreSQL - **Redis Performance:** Monitor cache hit rates - **ML Processing:** Monitor GPU/CPU usage - **Storage Usage:** Monitor disk space ## Backup Configuration **Kopia Integration:** - **Backup Paths:** - /mnt/user/appdata/immich (configuration) - PostgreSQL database dumps - Thumbnail cache (optional) - **Schedule:** Daily at 1:00 AM - **Retention:** 30 daily, 12 monthly **Database Backups:** - **pg_dump:** Daily database exports - **Incremental:** Use PostgreSQL WAL archiving - **Testing:** Regular restore testing ## Testing Procedures **Health Checks:** 1. **Container Status:** docker ps | grep immich 2. **Database Connection:** Test PostgreSQL connectivity 3. **Redis Connection:** Test cache connectivity 4. **Web Interface:** Access via browser **Functionality Tests:** 1. **Photo Upload:** Test manual upload 2. **Library Scan:** Test automatic detection 3. **Face Recognition:** Test person tagging 4. **Search Function:** Test smart search 5. **Mobile Sync:** Test mobile app connection **Performance Tests:** 1. **Upload Speed:** Test large file uploads 2. **Thumbnail Generation:** Test processing speed 3. **Search Response:** Test query performance 4. **Mobile Sync:** Test backup speed ## Troubleshooting **Common Issues:** 1. **Database Connection Failed:** - Verify PostgreSQL is running - Check database credentials - Validate network connectivity - Review PostgreSQL logs 2. **Machine Learning Not Working:** - Check ML container status - Verify GPU drivers if using GPU - Monitor resource usage - Review ML container logs 3. **Slow Performance:** - Check database performance - Monitor Redis cache hit rates - Verify storage I/O performance - Review thumbnail generation settings 4. **Mobile App Issues:** - Verify server accessibility - Check SSL certificate if using HTTPS - Validate mobile app credentials - Review server logs for authentication errors **Permission Fixes:** ```bash sudo chown -R 99:100 /mnt/user/appdata/immich sudo chmod -R 755 /mnt/user/appdata/immich sudo chown -R 99:100 /mnt/user/Photos sudo chmod -R 755 /mnt/user/Photos ``` **Log Locations:** - **Container Logs:** docker logs immich-server - **Application Logs:** /mnt/user/appdata/immich/logs - **Database Logs:** PostgreSQL container logs - **ML Logs:** Machine learning container logs ## Maintenance **Regular Tasks:** 1. **Library Maintenance:** Monthly library scans 2. **Database Maintenance:** Weekly VACUUM and ANALYZE 3. **Thumbnail Cleanup:** Remove orphaned thumbnails 4. **Log Rotation:** Manage log file sizes 5. **Security Updates:** Update containers regularly **Performance Optimization:** 1. **Database Tuning:** Optimize PostgreSQL settings 2. **Redis Configuration:** Tune cache settings 3. **Storage Optimization:** Monitor and optimize storage 4. **Hardware Acceleration:** Enable GPU processing if available **Storage Management:** 1. **Disk Usage:** Monitor photo storage growth 2. **Cleanup Tasks:** Remove duplicate files 3. **Archive Strategy:** Plan for long-term storage 4. **Backup Verification:** Regularly test backup integrity
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
tonym
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: tonym/NastyNAS#35
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?