goreleaser/www/content/install.md

title	weight	menu
Install	2	true

You can install the pre-compiled binary, use Docker or compile from source.

Install the pre-compiled binary

homebrew tap:

$ brew install goreleaser/tap/goreleaser

homebrew (may not be the latest version):

$ brew install goreleaser

snapcraft:

$ snap install goreleaser

scoop:

$ scoop bucket add goreleaser https://github.com/goreleaser/scoop-bucket.git
$ scoop install goreleaser

deb/rpm:

Download the .deb or .rpm from the releases page and install with dpkg -i and rpm -i respectively.

manually:

Download the pre-compiled binaries from the releases page and copy to the desired location.

Running with Docker

You can use Docker to do simple releases. Currently, the provided docker image does not provide support for snapcraft.

$ docker run --rm --privileged \
  -v $PWD:/go/src/github.com/user/repo \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -w /go/src/github.com/user/repo \
  -e GITHUB_TOKEN \
  -e DOCKER_USERNAME \
  -e DOCKER_PASSWORD \
  -e DOCKER_REGISTRY \
  goreleaser/goreleaser release

Note that the image will almost always have the last stable Go version.

The DOCKER_REGISTRY environment variables can be left empty when you are releasing to the public docker registry.

If you need more things, you are encouraged to have your own image. You can always use GoReleaser's own Dockerfile as an example though.

Compiling from source

Note

: this method requires Go 1.11+.

$ git clone git@github.com:goreleaser/goreleaser.git
$ cd goreleaser
$ make setup build

After that, the goreleaser binary will be in the root folder:

$ ./goreleaser --help

For more information, check the contributing guide.