Repository files navigation

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

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

Concourse is distributed as a singleconcourse binary, available on theReleases page.

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

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

• Docker image
• Kubernetes Helm chart
• BOSH release

$ wget https://concourse-ci.org/docker-compose.yml$ docker-compose up -dCreating docs_concourse-db_1 ...doneCreating docs_concourse_1    ...done

Concourse will be running athttp://localhost:8080.You can log in with the username/password astest/test.

Next, installfly by downloading it from the web UI athttp://localhost:8080/download-fly andtarget your local Concourse as thetest user:

$ fly -t ci login -c http://localhost:8080 -utest -ptestloggingin to team'main'target saved

You can follow ourGetting Started Tutorialto learn how to write Concourse pipelines.

Concourse has no GUI for configuration. Instead, pipelines are defined indeclarative YAML files:

resources:-name:booklittype:gitsource:{uri: "https://github.com/concourse/booklit"}jobs:-name:unitplan:  -get:booklittrigger:true  -task:testfile:booklit/ci/test.yml

Most operations are done via the accompanyingfly CLI. If you've got Concourseinstalled, try saving the above exampleasbooklit.yml,target your Concourseinstance, and then run:

fly -t ci set-pipeline -p booklit -c booklit.yml

These pipeline files are self-contained, making them easily portable betweenConcourse instances.

• TheOfficial Site for documentation,reference material, and example pipelines.
• TheGetting Started Tutorialto learn the basics of Concourse
• See Concourse in action with ourown pipelines
• Hang around in theGitHub discussions or inDiscord
• See what we're working on theproject board.

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

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