---
layout: developer-doc
title: Getting Enso
category: summary
tags: [contributing, installation]
order: 5
---

# Getting Enso
Enso packages can currently be obtained from the per-commit CI builds.
See [the build workflow on GitHub Actions](https://github.com/luna/enso/actions?query=workflow%3A%22Enso+CI%22).
The artifact of interest is `enso-<version>` (currently `enso-0.0.1`).

<!-- MarkdownTOC levels="2,3" autolink="true" -->

- [Dependencies](#dependencies)
- [Running Enso](#running-enso)
- [Troubleshooting](#troubleshooting)

<!-- /MarkdownTOC -->

## Dependencies
The Enso distribution requires to be run with the appropriate version of
GraalVM. You can get the Community Edition pre-built distributions from
[the GitHub releases site](https://github.com/graalvm/graalvm-ce-builds/releases).
It is important to run Enso with exactly the version specified here. Given that
Graal is still a relatively young project, even the minor version changes
introduce breaking API changes. The current version of GraalVM required for
Enso is `20.1.0`.

Before running the Enso packages, make sure that the `JAVA_HOME` environment
variable points to the correct home location of the Graal distribution.

## Running Enso
The distribution contains two main executables of interest:

1. The project manager. This executable is currently used for testing the IDE,
   though in the future it will rarely be run directly and rather will be 
   launched automatically by the IDE. To run the project manager, run the
   `bin/project-manager` script (Linux and MacOS) or the
   `bin/project-manager.bat` script (Windows).
2. The Enso CLI. This allows to create and run Enso projects from the command
   line. To launch the Enso CLI, run the `bin/enso` script (Linux and MacOS) or
   the `bin/enso.bat` script (Windows).
   
Again, it is necessary for you to set the `JAVA_HOME` variable correctly.

## Troubleshooting
This section lists the most common failures and their probable causes.

1. The exception `java.lang.IllegalArgumentException: Could not find option with name enso-runtime-server.enable.`
   It can contain a different option name. This exception signals problems with
   the Graal distribution. Make sure you're running Enso with the correct
   version of GraalVM. You can verify the version of JDK used by running
   `bin/enso --version`. Take note of the version displayed in the `Running on`
   section. It should be similar to:
   ```
   Running on: OpenJDK 64-Bit Server VM GraalVM CE 20.1.0, JDK 1.8.0_252-b09
               Mac OS X 10.15.3 (x86_64)
   ```
   It could also be caused by not using the launcher scripts and trying to run
   the component `.jar` files via `java -jar` without setting the necessary
   options. Use the launcher scripts.