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
---
2019-11-08 03:19:27 +04:00
There are currently two ways to get started with Ligo. You can choose to use a Docker image, 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:
* Use our installation script to set up a globally available LIGO
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 ).
2019-07-10 11:28:25 +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 ).
2019-11-08 03:19:27 +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-02-07 22:46:01 +04:00
> You can install additional ligo versions by replacing `next` with the desired version number
2019-06-06 18:49:47 +04:00
2019-10-01 14:15:51 +04:00
Download the latest binaries here: https://gitlab.com/ligolang/ligo/pipelines/85536879/builds or get the latest pre-release:
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
**Verify your ligo installation by running:**
```zsh
ligo --help
```
2019-10-01 18:21:01 +04:00
## Debian Linux package installation
2019-11-08 03:19:27 +04:00
We have produced .deb packages for a few Debian Linux versions. They will install a global `ligo` executable.
First download one of the packages below, and then install using:
```
sudo apt install ./< package_name_here > .deb
```
2019-10-01 18:21:01 +04:00
- [Ubuntu 18.04 ](/deb/ligo_ubuntu-18.04.deb )
- [Ubuntu 19.04 ](/deb/ligo_ubuntu-19.04.deb )
- [Debian 9 ](/deb/ligo_debian-9.deb )
- [Debian 10 ](/deb/ligo_debian-10.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 ).