Corso is a Go project, and you can build it with
go build from
if you have Go installed on your system.
# run from within `./src`
go build -o corso
If you don't have Go available, you can find installation instructions here
This will generate a binary named
corso in the directory where you run the build.
Prebuilt binary artifacts of the latest commit are available on GitHub.
You can access them by navigating to the "Summary" page of
Build/Release Corso CI job
that was run for the latest commit on the
The downloads will be available in the "Artifacts" section towards the
bottom of the page.
Building via Docker
For convenience, the Corso build tooling is containerized. To take advantage, you need Docker installed on your machine.
To build Corso via docker, use the following command from the root of your repo:
By default, we will build for your current platform. You can pass in
all the architectures/platforms you would like to build it for using
--platforms flag as a comma separated list. For example, if you
would like to build
arm64 versions for Linux, you can
run the following command:
./build/build.sh binary --platforms linux/amd64,linux/arm64
Once built, the resulting binaries will be available in
<repo root>/bin for all the different platforms you specified.
If you prefer to build Corso as a container image, use the following command instead:
# Use --help to see all available options
Dockerfile used to build the image is available at
Similar to binaries, we build your a container image for your current
platform by default, but you can change it by explicitly passing in
the platforms that you would like to build for.
In addition, you can optionally pass the tag that you would like to
apply for the image using
For example, you can use the following command to create a
image with the tag
ghcr.io/alcionai/corso:latest, you can run:
./build/build.sh image --platforms linux/arm64 --tag ghcr.io/alcionai/corso:latest
If you run into any issues with building cross platform images, make sure to follow the instructions on Docker docs to setup the build environment for Multi-platform images.