# Install immich-go with Homebrew, MacPorts, Nix, pacman, winget

Alternative to the official immich-CLI command written in Go. Version 0.32.0 via Homebrew; verified 2026-07-26. Also installable with nix: nix profile install nixpkgs#immich-go.

## Install

```sh
sudo av install brew:immich-go
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install immich-go
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install immich-go
```

  Evidence: MacPorts ports tree: graphics/immich-go/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#immich-go
```

  Evidence: nixpkgs package indexes: pkgs/by-name/im/immich-go/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S immich-go
```

  Evidence: Arch Linux sync databases: immich-go from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

### Windows

- winget (92%):

```sh
winget install --id simulot.immich-go -e
```

  Evidence: Windows Package Manager source index: simulot.immich-go from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:immich-go
- **Package manager:** Homebrew
- **Version:** 0.32.0
- **Source summary:** Alternative to the official immich-CLI command written in Go
- **Homepage:** <https://github.com/simulot/immich-go>
- **Repository:** <https://github.com/simulot/immich-go>
- **Last updated:** 2026-07-26T04:07:48+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- immich-go (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.32.0
## Project history and usage

immich-go is a community-maintained Go utility for uploading and migrating large photo collections into Immich. Its README describes it as an open-source tool for uploading from local folders, Google Photos Takeout, iCloud exports, ZIP archives, and other Immich servers without requiring Node.js or Docker.

### Project history

The GitHub repository was created on 2023-07-21. The project's motivation document says the author needed to migrate NAS-stored photos and Google Photos content into Immich, wanted better handling of Google Takeout archive oddities, and chose Go partly to avoid deploying a Node.js program to user machines.

As Immich's API changed, immich-go tracked the server ecosystem rather than standing still as a one-off importer. Release metadata for v0.32.0 in June 2026 explicitly calls out compatibility work for Immich V3 while maintaining compatibility with Immich V2.

### Adoption history

immich-go became important because the official Immich CLI intentionally keeps a narrower scope. The official Immich CLI documentation recommends immich-go for Google Photos Takeout imports, giving the community tool a clear place in the official migration story.

The repository has several thousand GitHub stars in repository metadata, and the input metadata records packages across Homebrew, Nix, Arch, and winget. Homebrew formula analytics also show more installs than several smaller image tools in this batch, consistent with active use by self-hosters migrating large libraries.

### How it is used

The README documents commands for uploading from folders and Google Photos Takeout archives, archiving from an Immich server, duplicate detection, album and tag creation, RAW+JPEG and burst-photo stacking, iCloud import, server-to-server migration, and skipped-file patterns for common system artifacts. Its command style centers on explicit --server and --api-key options.

### Why package nerds care

immich-go is package-nerd significant because it is a classic static-binary answer to a fast-moving web application's migration pain. It complements the official CLI by trading monorepo alignment for easy cross-platform distribution and specialized import heuristics, especially around Google Photos Takeout metadata.

### Timeline

- 2023-07-21: GitHub repository created.
- 2025-03-22: v0.25.0 release published with iCloud import noted in the release name.
- 2025-09-22: v0.28.0 release published with concurrent uploads noted in the release name.
- 2025-11-23: v0.31.0 release published.
- 2026-06-25: v0.32.0 release published with Immich V3 compatibility.

### Related projects

- immich-go is built around the Immich server API and is explicitly related to immich-cli. Its migration focus also connects it to Google Photos Takeout and iCloud export workflows.

### Sources

- <https://docs.immich.app/features/command-line-interface>
- <https://formulae.brew.sh/formula/immich-go>
- <https://github.com/simulot/immich-go>
- <https://github.com/simulot/immich-go/blob/main/docs/misc/motivation.md>
- <https://github.com/simulot/immich-go/releases>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Other Package-Manager Records

- Nix - immich-go: normalized package name match | nixpkgs package indexes: pkgs/by-name/im/immich-go/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman - immich-go - 1:0.32.0-1: normalized package name match | Arch Linux sync databases: immich-go from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Unofficial immich-cli alternative | https://github.com/simulot/immich-go
- MacPorts - immich-go: normalized package name match | MacPorts ports tree: graphics/immich-go/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- winget - simulot.immich-go: normalized package name match | Windows Package Manager source index: simulot.immich-go from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/immich-go.yml](https://github.com/mxcl/pkgdb/blob/main/combined/immich-go.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
