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 YUM repository and install via 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 yum 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 -

echo "deb https://download.gocd.org /" | sudo tee /etc/apt/sources.list.d/gocd.list
curl https://download.gocd.org/GOCD-GPG-KEY.asc | sudo apt-key add -
sudo apt-get update

Once you have the repository setup, execute

sudo apt-get install go-server

Alternatively, if you have the server DEB downloaded:

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

Install on Docker containers

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

For installing GoCD server using rpm/deb packages on containers, starting from release 19.7.0 the following additional dependencies will be required.

On Fedora, install procps package, execute

sudo yum install procps

On CentOS/RHEL, install sysvinit-tools package, execute

sudo yum install sysvinit-tools

Managing the GoCD server process

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

Script	Description
service go-server console	The GoCD server will be started in the foreground
service go-server start	The GoCD server will be started as a daemon in the background
service go-server stop	The GoCD server will be stopped
service go-server restart	The GoCD server will be restarted

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:

Location	Description
`/var/lib/go-server/db`	the GoCD server database
`/var/lib/go-server/artifacts`	the GoCD server artifacts
`/var/lib/go-server/plugins`	the GoCD server plugins
`/etc/go`	the GoCD server configuration
`/var/log/go-server`	the GoCD server log files
`/usr/share/go-server`	the GoCD server binaries and startup scripts
`/usr/share/go-server/wrapper-config/wrapper-properties.conf`	the configuration file to alter GoCD server properties

Overriding default startup arguments and environment

Users can override default startup arguments in a editing the file /usr/share/go-server/wrapper-config/wrapper-properties.conf.