Skip to main content
Version: 2.0.8

Installation

Native launcher​

Linux & macOS​

On Linux and macOS, download and run the coursier launcher with

$ curl -fLo cs https://git.io/coursier-cli-"$(uname | tr LD ld)"
$ chmod +x cs
$ ./cs

Note: The above instructions explain how to install a local copy of cs. The next thing you may want to do is to add cs to your PATH. The easiest way to accomplish this is to let cs do it for you! The following adapted installation instructions show the complete process:

$ curl -fLo cs https://git.io/coursier-cli-"$(uname | tr LD ld)"
$ chmod +x cs
$ ./cs install cs
$ rm cs

Apart from now having cs on your PATH, updating cs is now as simple as executing the following command:

$ cs update cs

macOS - brew based installation​

Alternatively, the native launcher can be installed via homebrew with

$ brew install coursier/formulas/coursier
$ cs

Windows​

On Windows, use

> bitsadmin /transfer cs-cli https://git.io/coursier-cli-windows-exe "%cd%\cs.exe"
> .\cs --help

Note that this must be run with cmd.exe, not PowerShell.

JAR-based launcher​

In case you run into any issue with the native launcher, a JAR-based launcher is available.

The commands below install the JAR-based launcher as coursier, which can be substituted to cs in the various examples on this website.

Linux / macOS​

Download and run the launcher with

$ curl -fLo coursier https://git.io/coursier-cli &&
chmod +x coursier &&
./coursier

Note that the JAR-based launcher requires Java 8 or later to run. That is, a command like java -version should print a version >= 8.

The JAR-based launcher weights only about 25 kB and can be easily embedded as is in other projects. It downloads the artifacts required to launch coursier on the first run.

Alternatively, on macOS, the JAR-based launcher can be installed via homebrew with

$ brew install coursier/formulas/coursier
$ coursier

Windows​

Install and run the JAR-based coursier launcher from the current directory at the Windows prompt, with

> bitsadmin /transfer downloadCoursierCli https://git.io/coursier-cli "%cd%\coursier"
> bitsadmin /transfer downloadCoursierBat https://git.io/coursier-bat "%cd%\coursier.bat"

You can then run coursier from the same directory, like

> coursier resolve io.circe:circe-core_2.12:0.10.0

Arch Linux​

Install it from AUR,

$ pacaur -S coursier

FreeBSD​

Install it via pkg from the Ports Collection,

$ pkg install coursier

zsh completions​

If you use ZSH, simple tab-completions are available by writing the coursier completion data into your completions directory. You can install the completions with:

mkdir -p ~/.zsh/completion
cs --completions zsh > ~/.zsh/completion/cs
echo 'fpath=(~/.zsh/completion $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit ; compinit' >> ~/.zshrc

Launcher URLs​

Latest launchers​

The various git.io shortened URLs above redirect to the latest launchers from the launchers repository:

OSShort URLredirects to
Linuxhttps://git.io/coursier-cli-linuxhttps://github.com/coursier/launchers/raw/master/cs-x86_64-pc-linux
macOShttps://git.io/coursier-cli-macoshttps://github.com/coursier/launchers/raw/master/cs-x86_64-apple-darwin
Windowshttps://git.io/coursier-cli-windows-exehttps://github.com/coursier/launchers/raw/master/cs-x86_64-pc-win32.exe
Any (needs JVM)https://git.io/coursier-clihttps://github.com/coursier/coursier/raw/gh-pages/coursier (gh-pages branch of coursier repository rather than launchers repository)
Any (needs JVM)https://github.com/coursier/launchers/raw/master/coursier (same launcher as above)

Specific versions​

To download specific versions of the launcher, download them from GitHub release assets:

OSURLSince version
Linuxhttps://github.com/coursier/coursier/releases/download/v2.0.8/cs-x86_64-pc-linux2.0.0-RC3-1
macOShttps://github.com/coursier/coursier/releases/download/v2.0.8/cs-x86_64-apple-darwin2.0.0-RC3-1
Windowshttps://github.com/coursier/coursier/releases/download/v2.0.8/cs-x86_64-pc-win32.exe2.0.0-RC6
Any (needs JVM)https://github.com/coursier/coursier/releases/download/v2.0.8/coursier1.1.0-M9
Any (needs JVM)https://github.com/coursier/coursier/raw/v1.1.0-M9/coursier (up to version 1.1.0-M9)Invalid for newest versions