Public Repository

Last pushed: a month ago
Short Description
GoCD server running on docker
Full Description

GoCD Server Docker image

An Alpine Linux based docker image for GoCD server.


docker run -d -p8153:8153 -p8154:8154 gocd/gocd-server:v17.12.0

This will expose container ports 8153 (for http) and 8154 (for https) onto your server.
You can now open http://localhost:8153 and https://localhost:8154.

NOTE: You need to specify the version of the docker image (v17.12.0, ...), since the latest tag is not published, by choice. See this for more details.

Available configuration options

Mounting volumes

The GoCD server will store all configuration, pipeline history database,
artifacts, plugins, and logs into /godata. If you'd like to provide secure
credentials like SSH private keys among other things, you can mount /home/go

docker run -v /path/to/godata:/godata -v /path/to/home-dir:/home/go gocd/gocd-server

Note: Ensure that /path/to/home-dir and /path/to/godata is accessible by the go user in container (go user - uid 1000).

Installing plugins

All plugins can be installed under /godata.

mkdir -p /path/to/godata/plugins/external
curl --location --fail > /path/to/godata/plugins/external/plugin.jar
chown -R 1000 /path/to/godata/plugins

Installing addons

All addons can be installed under /godata.

mkdir -p /path/to/godata/addons
curl --location --fail > /path/to/godata/addons/plugin.jar
chown -R 1000 /path/to/godata/addons

Tweaking JVM options (memory, heap etc)

JVM options can be tweaked using the environment variable GO_SERVER_SYSTEM_PROPERTIES.

docker run -e GO_SERVER_SYSTEM_PROPERTIES="-Xmx4096mb -Dfoo=bar" gocd/gocd-server

Under the hood

The GoCD server runs as the go user, the location of the various directories is:

Directory Description
/godata/addons the directory where GoCD addons are stored
/godata/artifacts the directory where GoCD artifacts are stored
/godata/config the directory where the GoCD configuration is store
/godata/db the directory where the GoCD database and configuration change history is stored
/godata/logs the directory where GoCD logs will be written out to
/godata/plugins the directory containing GoCD plugins
/home/go the home directory for the GoCD server

Determine Server IP and Ports on Host

Once the GoCD server is up, we should be able to determine its ip address and the ports mapped onto the host by doing the following:
The IP address and ports of the GoCD server in a docker container are important to know as they will be used by the GoCD agents to connect to it.
If you have started the container with

$ docker run --name server -it -p8153:8153 -p8154:8154 gocd/gocd-server:v17.12.0

Then, the below commands will determine to GoCD server IP, server port and ssl port

$ docker inspect --format='{{(index (index .NetworkSettings.IPAddress))}}' server
$ docker inspect --format='{{(index (index .NetworkSettings.Ports "8153/tcp") 0).HostPort}}' server
$ docker inspect --format='{{(index (index .NetworkSettings.Ports "8154/tcp") 0).HostPort}}' server


The GoCD server does not come up

  • Check if the docker container is running docker ps -a
  • Check the STDOUT to see if there is any output that indicates failures docker logs CONTAINER_ID
  • Check the server logs docker exec -it CONTAINER_ID tail -f /godata/logs/go-server.log (or check the log file in the volume mount, if you're using one)

Bugs with Docker Server Image 17.3.0

  • Anyone using our docker image as the base image for your customized image, and writing to /home/go as part of your Dockerfile, these changes in /home/go don't persist while you start the container with your custom image.
    A fix has been applied here and will be available for subsequent releases of the docker images.

Building the Docker Image locally

To build one with version 17.12.0; zip file is from GoCD download webpage.

GOCD_VERSION=17.12.0 \
rake build_image


Copyright 2017 ThoughtWorks, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
Docker Pull Command