You can install the pre-compiled binary (in several different ways), use Docker or compile from source.

Here are the steps for each of them:

Install the pre-compiled binary

homebrew tap (only on macOS for now):

$ brew install goreleaser/tap/goreleaser

homebrew (may not be the latest version):

$ brew install goreleaser


$ sudo snap install --classic goreleaser


$ scoop bucket add goreleaser
$ scoop install goreleaser


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


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

Running with Docker

You can also use it within a Docker container. To do that, you’ll need to execute something more-or-less like the following:

$ docker run --rm --privileged \
  -v $PWD:/go/src/ \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -w /go/src/ \
  goreleaser/goreleaser release

ATTENTION: Currently, the provided docker image does not support the generation of snapcraft packages.

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

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

If you need more things, you are encouraged to keep your own image. You can always use GoReleaser’s own Dockerfile as an example though and iterate from that.

Compiling from source

Here you have two options:

  1. If you want to contribute to the project, please follow the steps on our contributing guide.
  2. If just want to build from source for whatever reason, follow the steps bellow:

    # clone it outside GOPATH
    git clone
    cd goreleaser
    # get dependencies using go modules (needs go 1.11+)
    go get ./...
    # build
    go build -o goreleaser .
    # check it works
    ./goreleaser --version

Last updated by Carlos Alexandro Becker on August 19, 2019. Improve this page.