Installing GoCD server on Linux

Installation of the GoCD server using the package manager will require root access on the machine.

RPM based distributions (ie RedHat/CentOS/Fedora)

The GoCD server RPM installer has been tested on RedHat Enterprise Linux and CentOS. It should work on most RPM based Linux distributions.

If you prefer to use the dnf/yum repository and install via dnf/yum, paste the following in your shell -

sudo curl https://download.gocd.org/gocd.repo -o /etc/yum.repos.d/gocd.repo

Once you have the repository setup, execute

sudo dnf install -y go-server

Alternatively, if you have the server RPM downloaded:

sudo rpm -i go-server-${version}.noarch.rpm

Debian based distributions (ie Ubuntu)

The GoCD server .deb installer has been tested on Ubuntu. However it should work on most Linux distributions which use debs.

If you prefer to use the APT repository and install via apt-get, paste the following in your shell -

sudo install -m 0755 -d /etc/apt/keyrings
curl https://download.gocd.org/GOCD-GPG-KEY.asc | sudo gpg --dearmor -o /etc/apt/keyrings/gocd.gpg
sudo chmod a+r /etc/apt/keyrings/gocd.gpg
echo "deb [signed-by=/etc/apt/keyrings/gocd.gpg] https://download.gocd.org /" | sudo tee /etc/apt/sources.list.d/gocd.list
sudo apt-get update

Once you have the repository setup, execute

sudo apt-get install --install-recommends go-server

Alternatively, if you have the server DEB downloaded:

sudo dpkg -i go-server-${version}.deb

Recommended dependencies are installed by default on most distributions so the option isn’t needed, however if you choose not to install such dependencies you will need to install your own JRE and configure GoCD to use it in wrapper-properties.conf located within the configuration directory specified below.

Install on Docker containers

To run GoCD on container please use our official docker container images

If it possible to install via rpm/deb packages as well, however this is not normally recommended as the GoCD server packages are intended to be installed with an init system rather than managed via the container entrypoint.

Managing the GoCD server process

The GoCD server script must be run with one of the following arguments:

service utilizes the service manager (e.g systemd, upstart, init.d) used by your OS.

Once the GoCD server is started it will print out the URL for the Dashboard page. This will be http://localhost:8153/go

Location of GoCD server files

The GoCD server installs its files in the following locations on your filesystem:

Overriding default startup arguments and environment

Also see

• Installing GoCD agents
• Configuring server details
• Configure GoCD to work with a proxy
• Backing up a GoCD server