2019-05-13 17:55:32 +04:00
---
2019-06-11 05:37:12 +04:00
id: installation
2019-05-13 17:55:32 +04:00
title: Installation
---
2020-05-05 06:35:03 +04:00
There are currently three ways to get started with LIGO. You can choose to use a Docker image, a static Linux binary or to install packages for your Debian Linux distribution.
2019-05-13 17:55:32 +04:00
2019-06-06 18:49:47 +04:00
## Dockerized installation (recommended)
2019-05-13 17:55:32 +04:00
> 🐳 You can find instructions on how to install Docker [here](https://docs.docker.com/install/).
2019-11-08 03:19:27 +04:00
It's easiest to use LIGO through one of its Docker images. You have two options:
2020-05-05 06:35:03 +04:00
* Use our installation script to set up a globally available `ligo`
2019-11-08 03:19:27 +04:00
executable (see below). This manages the Docker bits for you.
* Use the Docker image available at [Docker Hub ](https://hub.docker.com/r/ligolang/ligo ).
2020-05-05 06:35:03 +04:00
This lets you run multiple versions and keep your installation(s) self-contained but requires more familiarity with Docker.
2019-11-08 03:19:27 +04:00
2020-01-22 19:16:08 +04:00
Sources for the image can be found on [GitLab ](https://gitlab.com/ligolang/ligo/blob/master/docker/Dockerfile ).
2020-05-05 06:35:03 +04:00
If this is your first time using Docker, you probably want to set up a global `ligo` executable as shown below.
2019-05-13 17:55:32 +04:00
### Setting up a globally available `ligo` executable
2019-06-06 18:49:47 +04:00
2020-05-05 06:35:03 +04:00
<!--
> You can install additional LIGO versions by replacing `next` with the desired version number
-->
2019-06-06 18:49:47 +04:00
2020-05-05 06:35:03 +04:00
Get the latest pre-release:
2019-10-01 14:15:51 +04:00
2019-05-13 17:55:32 +04:00
```zsh
2019-06-06 18:49:47 +04:00
# next (pre-release)
2019-06-06 21:51:38 +04:00
curl https://gitlab.com/ligolang/ligo/raw/dev/scripts/installer.sh | bash -s "next"
2019-06-14 16:53:11 +04:00
```
<!--
```
2019-06-06 18:49:47 +04:00
# e.g. 1.0.0 (stable)
2019-06-06 21:51:38 +04:00
curl https://gitlab.com/ligolang/ligo/raw/master/scripts/installer.sh | bash -s "1.0.0"
2019-06-06 18:49:47 +04:00
```
2019-06-14 16:53:11 +04:00
-->
2019-05-13 17:55:32 +04:00
2020-05-05 06:35:03 +04:00
**Verify your LIGO installation by running:**
2019-05-13 17:55:32 +04:00
```zsh
ligo --help
```
2020-05-21 19:56:44 +04:00
## Static Linux binary
2019-05-13 17:55:32 +04:00
2020-05-22 22:36:00 +04:00
The `ligo` executable is statically linked. It should run on most modern Linux distributions.
2019-10-01 18:21:01 +04:00
2020-05-05 06:35:03 +04:00
To use it, get it [here ](https://ligolang.org/bin/linux/ligo ), make it executable, you're done!
2019-11-08 03:19:27 +04:00
2020-05-21 19:56:44 +04:00
```zsh
wget https://ligolang.org/bin/linux/ligo
chmod +x ./ligo
2019-11-08 03:19:27 +04:00
```
2020-05-21 19:56:44 +04:00
Optionally, you can put it somewhere in your `PATH` for easy access:
```zsh
sudo cp ./ligo /usr/local/bin
2019-11-08 03:19:27 +04:00
```
2019-10-01 18:21:01 +04:00
2020-05-21 19:56:44 +04:00
## Debian Linux package installation
2020-05-22 22:36:00 +04:00
A `.deb` package containing the static `ligo` executable is also available.
2020-05-05 06:35:03 +04:00
First, download [the package ](https://ligolang.org/deb/ligo.deb ), and then install using:
2020-05-21 19:56:44 +04:00
```zsh
sudo apt install ./ligo.deb
```
2019-05-13 17:55:32 +04:00
2019-11-08 03:19:27 +04:00
## Release schedule
Important: LIGO is currently being released on a rolling release schedule. This means that you always get the latest development features. You can find our [rolling builds at the CI ](https://gitlab.com/ligolang/ligo/pipelines ).