Automatically sync faces to albums in Immich, recreating Google Photos partner sharing functionality.

Built on the amazing Python package immich-face-to-album by romainrbr.

Initially created as my wife and I have separate Immich accounts but would like to share photos of our daughter automatically.

• ✅ Unlimited Face Mappings: Configure as many face-to-album syncs as needed
• ✅ Multi-Account Support: Works across different Immich user accounts
• ✅ Incremental Sync: Only adds new photos, doesn't duplicate existing ones
• ✅ Dry Run Mode: Test configuration without making changes
• ✅ Health Checks: Built-in monitoring and error handling
• ✅ Unraid Ready: Includes Community Applications template

This is not an official immich project

Docker Compose:

Copy and paste this text into your docker-compose.yml file, make your own edits, and run it with docker-compose up -d

services:
  immich-partner-sharing:
    image: ajb3932/immich-partner-sharing:latest
    container_name: immich-partner-sharing
    restart: unless-stopped
    network_mode: host
    environment:
      - IMMICH_SERVER=http://localhost:2283
      - SYNC_INTERVAL_MINUTES=60
      - RUN_ONCE=false
      - DRY_RUN=false
      - SYNC_MAPPING_1=your-api-key-1:face-id-1:album-id-1:Photos of John
      - SYNC_MAPPING_2=your-api-key-2:face-id-2:album-id-2:Photos of Jane
      - SYNC_MAPPING_3=your-api-key-1:face-id-3:album-id-3:Photos of Kids
      # Add more mappings as needed...
    healthcheck:
      test: ["CMD", "python", "-c", "import requests; requests.get('${IMMICH_SERVER}/api/server-info')"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

Docker CLI:

⚠️ Must have an Immich server running and accessible.

docker run -d \
  --name immich-partner-sharing \
  --network host \
  -e IMMICH_SERVER="http://localhost:2283" \
  -e SYNC_MAPPING_1="your-api-key:face-id:album-id:Description" \
  --restart unless-stopped \
  ajb3932/immich-partner-sharing

The following Environment Variables are available:

1. Create shared albums for each account (e.g., "Partner Sharing - John", "Partner Sharing - Jane")
2. Generate API keys for each Immich user account
3. Find Face and Album IDs (see Finding IDs section below)
4. Configure environment variables with your mappings
5. Test with dry run mode first: DRY_RUN=true

API Keys: Immich → Account Settings → API Keys → Create

Face IDs: Immich → Explore → People → Click person → Copy ID from URL
Example URL: http://your-server/people/f3437c84-83f9-4e84-9640-0dcd12efd08e
Face ID: f3437c84-83f9-4e84-9640-0dcd12efd08e

Album IDs: Immich → Albums → Click album → Copy ID from URL
Example URL: http://your-server/albums/ff85e8c5-32e6-49e0-a0ad-e4dd7ef66bce
Album ID: ff85e8c5-32e6-49e0-a0ad-e4dd7ef66bce

For a family with Alex and Abbie's accounts sharing photos of their daughter Mabel:

# Alex's account syncing photos of Mabel and Abbie to Abbie's partner album
SYNC_MAPPING_1=alex-api-key:mabel-face-id:abbie-album-id:Mabel to Abbies album
SYNC_MAPPING_2=alex-api-key:abbie-face-id:abbie-album-id:Abbie to Abbies album

# Abbie's account syncing photos of Mabel and Alex to Alex's partner album  
SYNC_MAPPING_3=abbie-api-key:mabel-face-id:alex-album-id:Mabel to Alex album
SYNC_MAPPING_4=abbie-api-key:alex-face-id:alex-album-id:Alex to Alex album

🐳 Docker

git clone https://github.com/ajb3932/immich-partner-sharing.git
cd immich-partner-sharing
cp .env-example .env
# Edit .env with your configuration
docker build -t immich-partner-sharing .
docker run -d --env-file .env immich-partner-sharing

🐳 Docker Compose (edit .env file first)

git clone https://github.com/ajb3932/immich-partner-sharing.git
cd immich-partner-sharing
cp .env-example .env
# Edit .env with your configuration
docker-compose up -d

💾 Python (for development)

git clone https://github.com/ajb3932/immich-partner-sharing.git
cd immich-partner-sharing/app
pip install -r requirements.txt
# Set environment variables
python main.py

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

MIT License - feel free to use and modify!

• Built on immich-face-to-album by romainrbr
• Inspired by Google Photos partner sharing functionality
• Created for the amazing Immich self-hosted photo management platform