Clone or download
vito Merge pull request #2968 from concourse/dependabot/go_modules/github.…

Build(deps): bump from 0.9.0-pre1 to 0.9.2
Latest commit f4d888c Jan 20, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github add config for stale and no-response bots Jan 16, 2019
atc Merge pull request #3064 from concourse/feature/3007 Jan 18, 2019
bin remove --graph flag; no longer needed Nov 20, 2018
ci Merge pull request #3042 from cirocosta/issue/30000-rc-image Jan 18, 2019
examples create first example Sep 26, 2018
fly Revert "fly: sort teams detail output by roles" Jan 16, 2019
go-concourse go-concourse: fix lint error and sync fakes Jan 8, 2019
hack update Dec 12, 2018
screenshots add 2x scaled screenshot for hidpi laptops Sep 19, 2018
skymarshal replaced atc start verbiage with references to web instead Jan 19, 2019
testflight testflight: simplify fixture Nov 29, 2018
topgun Reduce tolerance on topgun test and improve test output Jan 7, 2019
tsa all: fake it til you make it Dec 3, 2018
web Merge pull request #3064 from concourse/feature/3007 Jan 18, 2019
worker bin/worker: adds health checker ifrit server Nov 15, 2018
.dockerignore flesh out Sep 25, 2018
.env run watsjs/testflight against prebuilt Concourse Oct 1, 2018
.gitignore Merging in master Nov 8, 2018 move important docs to root Nov 20, 2018 docs for web testing Dec 28, 2018
Dockerfile build web UI in Dockerfile Dec 12, 2018 re-init Sep 18, 2018 re-init Sep 18, 2018 README: include a link to the public GH Project board Dec 8, 2018
docker-compose-4.2.2.yml ci: update uber pipeline to not sync fly as it won't be available by … Dec 17, 2018
docker-compose.yml ci : don't wait twice for fly login to exit Nov 21, 2018
go.mod Merge pull request #2968 from concourse/dependabot/go_modules/github.… Jan 20, 2019
go.sum Merge pull request #2968 from concourse/dependabot/go_modules/github.… Jan 20, 2019
package.json web: remove pause button, refactor Oct 31, 2018
versions.go Revert "atc: time-resource should not share versions" Jan 10, 2019
yarn.lock atc: don't mark creating containers/volumes as missing Nov 14, 2018

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 Downloads 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.