local development cli
Go Shell
Latest commit eec884d Jan 4, 2017 @vito vito committed on GitHub Merge pull request #144 from joonas/add-team-to-targets
Include 'team' as part of the targets command output



A command line interface that runs a build in a container with ATC.

A good place to start learning about Concourse is its BOSH release.


Fly is built using Go. Building and testing fly is most easily done from a checkout of concourse.

  1. Check out concourse and update submodules:

    git clone --recursive https://github.com/concourse/concourse.git
    cd concourse
  2. Install direnv. Once installed you can cd in and out of the concourse directory to setup your environment.

  3. You can now build the the fly binary with go build:

    cd src/github.com/concourse/fly
    go build
  4. You can also now run tests by installing and running ginkgo:

    go get github.com/onsi/ginkgo/ginkgo
    ginkgo -r

Installing from the Concourse UI for Project Development

Fly is available for download in the lower right-hand corner of the concourse UI.

fly download links

  1. Navigate to your Concourse instance in the browser, and click the button corresponding to your OS

  2. Move the downloaded file onto your PATH

    install ~/Downloads/fly /usr/local/bin
  3. Confirm availability with which fly

Upgrading Fly

Fly is not available for upgrade independently of Concourse. You can download the corresponding upgraded version of Fly via the following:

  • using the Concourse UI
  • running fly -t example sync if you already have fly locally