Skip to content
Concourse is a container-based continuous thing-doer written in Go and Elm.
Go Elm PLpgSQL Ruby JavaScript CSS Other
Branch: master
Clone or download

Latest commit

aoldershaw Merge pull request #5397 from pnsantos/master
web: behaviour: bump @mdi/svg 4.5.95 -> 5.0.45
Latest commit 5d47620 Apr 2, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github oh; 'about', not 'description' Apr 1, 2020
atc atc: fix error in container gc down migration Mar 30, 2020
cmd cmd/init: add missing library Feb 11, 2020
fly Merge pull request #5329 from concourse/issue/5314 Mar 30, 2020
go-concourse go-concourse: Reduce overall diff of PR Feb 20, 2020
hack web: convert mdi-icons script to module Feb 28, 2020
release-notes web: behaviour: bump @mdi/svg 4.5.95 -> 5.0.45 Apr 2, 2020
screenshots add 2x scaled screenshot for hidpi laptops Sep 19, 2018
skymarshal skymarshal: use escaped path for redirect URI Mar 20, 2020
testflight testflight: lowercase check timeout err msg Mar 4, 2020
topgun k8s-topgun: remove containerd test Mar 24, 2020
tracing add tracing package Jan 22, 2020
tsa Merge pull request #3936 from cycloidio/gl_3551 Jan 17, 2020
vars vars: use go std err wrapping Mar 4, 2020
web web: behaviour: bump @mdi/svg 4.5.95 -> 5.0.45 Apr 2, 2020
worker worker/integration: add README Mar 24, 2020
.dockerignore flesh out Sep 25, 2018
.env run watsjs/testflight against prebuilt Concourse Oct 1, 2018
.gitignore web: add elm setup bundle to .gitignore Feb 28, 2020 move important docs to root Nov 20, 2018 Merge pull request #5237 from concourse/contributing-topgun Mar 19, 2020
Dockerfile remove containerd dependencies from Dockerfile Mar 12, 2020 re-init Sep 18, 2018 say "Present" in Apr 9, 2019 update link to new helm chart location Jan 9, 2020
docker-compose.yml docker-compose: bump db's shm_size Mar 23, 2020
go.mod Bump Feb 21, 2020
go.sum Bump Feb 21, 2020
package.json web: behaviour: bump @mdi/svg 4.5.95 -> 5.0.45 Apr 2, 2020
tools.go Add tools.go to keep track of tool versions Apr 8, 2019
versions.go concourse/#3819 using zstd to streamIn/Out between workers Jun 25, 2019
webpack.config.js web: babel-ify javascript bundle Feb 28, 2020
yarn.lock web: behaviour: bump @mdi/svg 4.5.95 -> 5.0.45 Apr 2, 2020

Concourse: the continuous thing-doer.

Concourse is an automation system written in Go. It is most commonly used for CI/CD, and is built to scale to any kind of automation pipeline, from simple to complex.

booklit pipeline

Concourse is very opinionated about a few things: idempotency, immutability, declarative config, stateless workers, and reproducible builds.


Concourse is distributed as a single concourse binary, available on the Releases page.

If you want to just kick the tires, jump ahead to the Quick Start.

In addition to the concourse binary, there are a few other supported formats. Consult their GitHub repos for more information:

Quick Start

$ wget
$ docker-compose up
Creating docs_concourse-db_1 ... done
Creating docs_concourse_1    ... done

Concourse will be running at You can log in with the username/password as test/test.

Next, install fly by downloading it from the web UI and target your local Concourse as the test user:

$ fly -t ci login -c -u test -p test
logging in to team 'main'

target saved

Configuring a Pipeline

There is no GUI for configuring Concourse. Instead, pipelines are configured as declarative YAML files:

- name: booklit
  type: git
  source: {uri: ""}

- name: unit
  - get: booklit
    trigger: true
  - task: test
    file: booklit/ci/test.yml

Most operations are done via the accompanying fly CLI. If you've got Concourse installed, try saving the above example as booklit.yml, target your Concourse instance, and then run:

fly -t $target set-pipeline -p booklit -c booklit.yml

These pipeline files are self-contained, maximizing portability from one Concourse instance to the next.

Learn More


Our user base is basically everyone that develops software (and wants it to work).

It's a lot of work, and we need your help! If you're interested, check out our contributing docs.

You can’t perform that action at this time.