immich-go

Immich-Go: Upload Your Photos to Your Immich Server

Immich-Go is an open-source tool designed to streamline uploading large photo collections to your self-hosted Immich server.

⚠️ This is an early version, not yet extensively tested
⚠️ Keep a backup copy of your files for safety

🌟 Key Features

• Simple Installation: No NodeJS or Docker required
• Multiple Sources: Upload from Google Photos Takeouts, iCloud, local folders, ZIP archives, and other Immich servers
• Large Collections: Successfully handles 100,000+ photos
• Smart Management: Duplicate detection, burst photo stacking, RAW+JPEG handling
• Cross-Platform: Available for Windows, macOS, Linux, and FreeBSD

🚀 Quick Start

1. Install Immich-Go

Download the pre-built binary for your system from the GitHub releases page.

2. Basic Usage

# Upload photos from a local folder
immich-go upload from-folder --server=http://your-ip:2283 --api-key=your-api-key /path/to/your/photos

# Upload Google Photos takeout
immich-go upload from-google-photos --server=http://your-ip:2283 --api-key=your-api-key /path/to/takeout-*.zip

# Archive photos from Immich server
immich-go archive from-immich --server=http://your-ip:2283 --api-key=your-api-key --write-to-folder=/path/to/archive

3. Requirements

• A running Immich server with API access
• API key with appropriate permissions (see full list)

📚 Documentation

🎯 Popular Use Cases

• Google Photos Migration: Complete guide
• iCloud Import: Step-by-step instructions
• Server Migration: Transfer between Immich instances
• Bulk Organization: Stacking and tagging strategies

💡 Support the Project

• GitHub Sponsor
• PayPal Donation

🤝 Contributing

Contributions are welcome! Please see our contributing guidelines for details.

📄 License

This project is licensed under the terms specified in the LICENSE file.

Need help? Check our documentation or open an issue on GitHub.