Advanced installation of GoCD agent using zip installer

If you want to run GoCD on a platform which does not have a native installer or want to run GoCD without installing it, you could do so by using the zip installers.

  • Download the zip installer for GoCD agent
  • Unzip the installer in a folder of your choice. It creates a subfolder with the name go-agent-${version}
  • Ensure that java executable is available on the PATH environment variable. If you have multiple versions of java, or want to use a version of java that is not available on PATH environment variable, edit the file wrapper-config/wrapper-properties.conf and change the variable wrapper.java.command to point to the java executable.

Managing the GoCD agent process

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

ScriptDescription
./bin/go-agent consoleThe GoCD agent will be started in the foreground
./bin/go-agent startThe GoCD agent will be started as a daemon in the background
./bin/go-agent stopThe GoCD agent will be stopped
./bin/go-agent restartThe GoCD agent will be restarted

Overriding default startup arguments and environment

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

Registering your agent with the server

For security reasons, all newly installed GoCD agents need to be enabled on the GoCD server before work is assigned to them. This prevents an unauthorized person from getting access to your source code. To enable a newly installed GoCD agent, do the following:

  1. Open the GoCD server dashboard
  2. Follow the instructions here to find the agent you’ve just installed on the list and add the agent to your cloud. The GoCD server will now schedule work for this agent.