Mac OS X

    Your query search resulted in no results.

    Installing GoCD server on Mac OS X

    Note: Installation of GoCD server on Mac OSX has been changed since GoCD version 19.3.0. If you are on an older version, please refer this document


    1. Download the Mac OSX installer for GoCD server from downloads page
    2. Unzip the installer in a folder of your choice. It creates a subfolder with the name go-server-${version}
    3. Open a command prompt and go to the folder
    4. To start the server, run:

        bin/go-server start


    Start the server:

    console         : The server will be started in the current console.
    start           : The server will start in the background as a daemon
    restart         : The server will stop if running and a fresh instance
                      will start.

    Stop the server:

    stop            : Stops the server if it is running as a daemon or in

    Overriding default startup arguments and environment

    • Open the file go-server-${version}/conf/wrapper-properties.conf.example
    • Copy any specific properties, or add new properties from go-server-${version}/conf/wrapper.conf into this file. Be sure to increment the property index if you’re adding any new properties.
    • For e.g. to override the -Xmx to 12GB, override -

      # config/wrapper-properties.conf
    • To append additional JVM args to the server

      # conf/wrapper.conf
      # We recommend you begin with index 100 for  ""
    • Each property must be configured separately

      # Having a single property for multiple configurations is invalid, e.g"'bar' -Dcruise.config.other='baz'"
      Valid properties,

      Please note : If the bin/go-server as an application is run by any user, then this user needs to have these required permissions to the go-server-${version} folder, i.e. modify, read and execute, list folder contents and read permissions.

    • Rename the said file to remove the .example extension.

    Location of GoCD server files

    All the files for the GoCD server are under the go-server-${version} folder.

    Copying existing config to a new GoCD Server instance

    You can replicate a GoCD server with all the pipeline, stage, job, tasks and materials definitions/configuration intact.

    To do this, the administrator should copy cruise-config.xml from the config directory (go-server-${version}/config) to the new server and clear serverId attribute of server tag.

    Note: Copying just the cruise-config.xml file will not migrate the historical pipeline data and artifacts. Please see the page on backing up the GoCD Server to fully migrate an existing GoCD server.

    Also see…