Installing GoCD server on Linux

    Your query search resulted in no results.

    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 -

    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 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.

    Also see