Installing GoCD server on Mac OS X

  • Download the Mac OS X installer for GoCD Server from downloads page.

  • Unzip the installer in a directory of your choice. It creates a sub-directory with the name go-server-${version}.

  • Mark the directory as not quarantined by Mac OS X so that it allows the GoCD Server to be started:

    1. # Assuming, for example, that the directory is "go-server-20.5.0".
    2. $ cd go-server-20.5.0
    3. $ xattr -d -r com.apple.quarantine .
    4. xattr: [Errno 13] Permission denied: './jre/Contents/Home/lib/server/classes.jsa'
    5. xattr: [Errno 13] Permission denied: './jre/Contents/Home/legal/jdk.dynalink/dynalink.md'
    6. ... # These "Permission denied" warnings can be ignored.

Managing the GoCD server process

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

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

Once the GoCD server is started the GoCD server will be started and 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:

LocationDescription
${INSTALL_DIR}/dbthe GoCD server database
${INSTALL_DIR}/artifactsthe GoCD server artifacts
${INSTALL_DIR}/pluginsthe GoCD server plugins
${INSTALL_DIR}/configthe GoCD server configuration
${INSTALL_DIR}/logsthe GoCD server log files
${INSTALL_DIR}/{lib,wrapper}the GoCD server binaries and startup scripts
${INSTALL_DIR}/wrapper-config/wrapper-properties.confthe configuration file to alter GoCD server properties

Overriding default startup arguments and environment

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

Also see