1.1.3 The concourse CLI

The concourse CLI can be downloaded from the latest GitHub release - make sure to grab the appropriate archive for your platform. Each concourse-* archive contains the following files:

concourse/bin/gdn            # on Linux
concourse/resource-types/... # on Linux

When extracted, the concourse binary will auto-discover its sibling assets based on its file location, so you may extract it anywhere. On Linux a typical install location is /usr/local/concourse:

tar -zxf concourse-*.tgz -C /usr/local

From there, you can either add /usr/local/concourse/bin to your $PATH, or just execute /usr/local/concourse/bin/concourse directly.

Configuring concourse

All Concourse web node and worker node configuration is defined statically via flags. For a full list of flags, you can pass --help to any command.

Each flag can also be set via an environment variable. The env var for each flag is based on the flag name, preceded with CONCOURSE_. These are also shown in --help.

Various sections in documentation may refer to configuration via env vars rather than flags, but they are both equivalent and interchangeable. Env vars are just easier to reference in isolation and are more useful to copy-paste.