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

Alternative to the official immich-CLI command written in Go. Version 0.32.0 via Homebrew; verified 2026-06-25.

## Install

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

Additional install commands:

### macOS

- Homebrew (100%):

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

  Evidence: local Homebrew formula metadata

### 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
- **Package manager page:** <https://formulae.brew.sh/formula/immich-go>
- **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>
- **Upstream docs:** <https://github.com/simulot/immich-go#readme>
- **License:** AGPL-3.0-only
- **Source archive:** <https://github.com/simulot/immich-go/archive/refs/tags/v0.32.0.tar.gz>
- **Last updated:** 2026-06-25T13:14:24Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- immich-go (cli)
- immich-go (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.32.0
- Package-manager updated: 2026-06-25
- Local data: ok
- Upstream repository: https://github.com/simulot/immich-go
- Upstream latest detected: v0.32.0 (current)
## 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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** immich-go
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 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.31.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
- 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


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [immich-cli](https://www.automicvault.com/pkg/brew/immich-cli/) - Shares av.db curated category or tags: cli, immich, media, photos.
- [caire](https://www.automicvault.com/pkg/brew/caire/) - Shares av.db curated category or tags: cli, go, media.
- [ente-cli](https://www.automicvault.com/pkg/brew/ente-cli/) - Shares av.db curated category or tags: cli, media, photos.
- [exif](https://www.automicvault.com/pkg/brew/exif/) - Shares av.db curated category or tags: cli, media, photos.
- [go-librespot](https://www.automicvault.com/pkg/brew/go-librespot/) - Shares av.db curated category or tags: cli, go, media.
- [gphotos-uploader-cli](https://www.automicvault.com/pkg/brew/gphotos-uploader-cli/) - Shares av.db curated category or tags: cli, go, media.
- [imgdiet](https://www.automicvault.com/pkg/brew/imgdiet/) - Shares av.db curated category or tags: cli, go, media.
- [imgproxy](https://www.automicvault.com/pkg/brew/imgproxy/) - Shares av.db curated category or tags: cli, go, media.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
