Skip to main content
igo (Install Go) is a CLI tool that lets you install, switch between, and manage multiple versions of Go on your system. It runs entirely in your $HOME directory and never requires sudo.

Installation

Download the igo binary for your platform and get set up in minutes

Quickstart

Install your first Go version and configure your shell environment

Commands

Full reference for all igo flags and commands

Configuration

Customize workspace directory, target OS, architecture, and more

Key features

No root required

Everything lives under ~/go. No system directories are touched.

Multiple versions

Install and keep as many Go versions as you need, switch instantly.

Shim-based resolution

Shims read go.mod or .go_version to auto-select the right version per project.

Shell auto-configuration

igo writes a ~/.igo activator script that sets GOROOT, GOBIN, GOPATH, and GOMODCACHE.

Supported platforms

PlatformArchitecture
macOSamd64 (Intel), arm64 (Apple Silicon)
Linuxamd64, arm64
Windows is not supported. Use Go’s official MSI installer on Windows instead.

Build docs developers (and LLMs) love