mise-en-place

Appearance

Go ​

mise can be used to install and manage multiple versions of go on the same system.

The following are instructions for using the go mise core plugin. This is used when there isn't a git plugin installed named "go". If you want to use asdf-golang then use mise plugins install go GIT_URL.

The code for this is inside the mise repository at ./src/plugins/core/go.rs.

Usage ​

The following installs the latest version of go-1.21.x (if some version of 1.21.x is not already installed) and makes it the global default:

sh
mise use -g [email protected]

Minor go versions 1.20 and below require specifying prefix before the version number because the first version of each series was released without a .0 suffix, making 1.20 an exact version match:

sh
mise use -g go@prefix:1.20

.go-version file support ​

mise uses a mise.toml or .tool-versions file for auto-switching between software versions. However, it can also read go-specific version files named .go-version.

See idiomatic version files

Default packages ​

Planned deprecation

Default package files are deprecated. They are still supported for now, but mise will start warning in 2026.11.0 and support will be removed in 2027.11.0.

For Go CLIs, install the tool directly with the go: backend:

toml
[tools]
"go:github.com/jesseduffield/lazygit" = "latest"

For packages that really should be installed into every Go version, use a tool-level postinstall hook:

toml
[tools]
go = { version = "1.25", postinstall = "go install github.com/daixiang0/gci@latest" }

mise can automatically install a default set of packages right after installing a new go version. To use this legacy feature, provide a $HOME/.default-go-packages file that lists one package per line, for example:

text
github.com/daixiang0/gci # allows comments
github.com/jesseduffield/lazygit

Tool Options ​

The following tool-options are available for the go backend. These options go in the [tools] section in mise.toml.

install_env ​

Set environment variables for default package installation and install-time verification commands run by the core go backend:

toml
[tools]
go = { version = "latest", install_env = { GOPRIVATE = "github.com/acme/*" } }

Settings ​

go.default_packages_filedeprecated

  • Type: string
  • Env: MISE_GO_DEFAULT_PACKAGES_FILE
  • Default: ~/.default-go-packages
  • Deprecated: Default go package files are deprecated. Use tool-level postinstall hooks for packages that should be installed into every go version, or use the go: backend for CLI tools.

Path to a file containing default go packages to install when installing go.

go.download_mirror

  • Type: string
  • Env: MISE_GO_DOWNLOAD_MIRROR
  • Default: https://dl.google.com/go

Mirror to download go sdk tarballs from.

go.repo

  • Type: string
  • Env: MISE_GO_REPO
  • Default: https://github.com/golang/go

URL to fetch go from.

go.set_gobin

  • Type: boolean(optional)
  • Env: MISE_GO_SET_GOBIN
  • Default: None

Defaults to ~/.local/share/mise/installs/go/.../bin. Set to true to override GOBIN if previously set. Set to false to not set GOBIN (default is ${GOPATH:-$HOME/go}/bin).

go.set_gopathdeprecated

  • Type: boolean
  • Env: MISE_GO_SET_GOPATH
  • Default: false
  • Deprecated: Use env._go.set_goroot instead.

[deprecated] Set to true to set GOPATH=~/.local/share/mise/installs/go/.../packages.

go.set_goroot

  • Type: boolean
  • Env: MISE_GO_SET_GOROOT
  • Default: true

Sets GOROOT=~/.local/share/mise/installs/go/.../.

go.skip_checksum

  • Type: boolean
  • Env: MISE_GO_SKIP_CHECKSUM
  • Default: false

Set to true to skip checksum verification when downloading go sdk tarballs.

MIT LicenseCopyright © 2026en.dev