Installation

Currently LIGO can be installed on Linux and MacOS. It is possible to use it on Windows through WSL or docker.

You can also try LIGO in a Gitpod environment by clicking this button:

Releases

Releases are available at the releases page of GitLab project. All the artifacts are attached there.

To see the changelog, you can either run ligo changelog or go to LIGO Changelog. The changelog contains links to corresponding releases.

Install

MacOS

Install LIGO with Homebrew:

brew tap ligolang/ligo https://gitlab.com/ligolang/ligo.git

brew install ligolang/ligo/ligo

To upgrade LIGO:

brew update

brew upgrade ligolang/ligo/ligo

Debian Linux

A .deb package containing the static ligo executable is available. First download the package and then install it with this command:

sudo apt install ./ligo.deb

Arch Linux

You can install the latest release of ligo through AUR:

git clone https://aur.archlinux.org/ligo-bin.git

cd ligo-bin

makepkg -si

It is also available through tools like yay:

yay -S ligo-bin

Docker

If you've installed 🐳 Docker, you can run the latest LIGO release in a Docker container with this command:

Linux or MacOS:

docker run --rm -v "$PWD":"$PWD" -w "$PWD" ligolang/ligo:1.10.0

Windows:

docker run --rm -v "%CD%":/cd -w /cd ligolang/ligo:1.10.0

For convenience, you can alias the command:

Linux or MacOS:

alias ligo='docker run --rm -v "$PWD":"$PWD" -w "$PWD" ligolang/ligo:1.10.0'

Windows:

doskey ligo=docker run --rm -v "%CD%":/cd -w /cd ligolang/ligo:1.10.2 $*

Then you can use the alias to run LIGO commands, as in this command:

ligo compile contract myContract.jsligo

To make this alias persistent across terminal sessions you must configure your shell to remember it. See these instructions for Linux or this stackoverflow answer for Windows.

To use the development version of LIGO, replace the version above (1.10.0) with next.

To run an older version of LIGO, you can get older Docker images on DockerHub.

Windows

It's possible to use ligo in Docker through docker or WSL2.

docker run --rm -v "%CD%":/cd -w /cd ligolang/ligo:1.10.0

For convenience, you can alias the command:

doskey ligo=docker run --rm -v "%CD%":/cd -w /cd ligolang/ligo:1.10.0 $*

Then you can use the alias to run LIGO commands, as in this command:

ligo compile contract myContract.jsligo

To make this alias persistent across terminal sessions you must configure your shell to remember it. See this stackoverflow answer.

To use the development version of LIGO, replace the version above (1.10.0) with next.

To run an older version of LIGO, you can get older Docker images on DockerHub.

Linux binary

The ligo executable is statically linked. It should run on most modern Linux distributions.

You can download the current release here, make it executable, and you are done! Optionally, you can put it somewhere in your PATH for easy access.

wget https://gitlab.com/ligolang/ligo/-/jobs/8861513110/artifacts/raw/ligo

chmod +x ./ligo

sudo cp ./ligo /usr/local/bin

To download a specific version, visit the release page, which provides packages for some Linux distributions and a static binary for all Linux distributions.

To upgrade, download a new file and replace the old one.