Skip to content

Add link to mise #1824

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
josevalim merged 1 commit into from
May 10, 2026
+28 −27
Merged

Add link to mise #1824

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 28 additions & 27 deletions install.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,10 +24,10 @@ Install Elixir according to your operating system and tool of choice.

- Using [install scripts](#install-scripts)

- Using [Homebrew](https://brew.sh/):
- Using [Homebrew](https://brew.sh):
* Run: `brew install elixir`

- Using [Macports](https://www.macports.org/):
- Using [Macports](https://www.macports.org):
* Run: `sudo port install elixir`

- Using [version managers](#version-managers)
Expand All @@ -36,8 +36,6 @@ Install Elixir according to your operating system and tool of choice.

Below we list steps for installing Elixir in different distributions. If your distribution is not listed or the steps below do not work, you may consider using [version managers](#version-managers).

#### Distributions

- **Arch Linux** (Community repository)
* Run: `pacman -S elixir`

Expand All @@ -53,24 +51,15 @@ Below we list steps for installing Elixir in different distributions. If your di
* Run: `guix package -i elixir`

- **Ubuntu**
* Use [install scripts](#install-scripts) (or alternatively [version managers](#version-managers))
* Using [install scripts](#install-scripts)
* The packages in `apt` tend to lag several versions behind. You may use [RabbitMQ Packages](https://launchpad.net/~rabbitmq) outlined below, which are likely newer than `apt`:

```bash
$ sudo add-apt-repository ppa:rabbitmq/rabbitmq-erlang
$ sudo apt update
$ sudo apt install git elixir erlang
```sh
sudo add-apt-repository ppa:rabbitmq/rabbitmq-erlang
sudo apt update
sudo apt install git elixir erlang
```

#### Version managers

There are many tools that allow developers to install and manage multiple Erlang and Elixir versions. They are useful if you have multiple projects running on different Elixir or Erlang versions, can't install Erlang or Elixir as mentioned above or if the version provided by your package manager is outdated. Here are some of those tools:

* [asdf](https://github.com/asdf-vm/asdf) - install and manage different [Elixir](https://github.com/asdf-vm/asdf-elixir) and [Erlang](https://github.com/asdf-vm/asdf-erlang) versions
* [kerl](https://github.com/kerl/kerl) - install and manage different Erlang versions

Keep in mind that each Elixir version supports specific Erlang/OTP versions. [See the supported versions alongside our docs](/docs).

### BSD

- **FreeBSD**
Expand All @@ -97,13 +86,15 @@ Keep in mind that each Elixir version supports specific Erlang/OTP versions. [Se

- Using [install scripts](#install-scripts)

- Using [Scoop](https://scoop.sh/):
- Using [Scoop](https://scoop.sh):
* Install Erlang: `scoop install erlang`
* Install Elixir: `scoop install elixir`

- Using [Chocolatey](https://community.chocolatey.org/):
- Using [Chocolatey](https://community.chocolatey.org):
* Install Elixir (installs Erlang as a dependency): `choco install elixir`

- Using [version managers](#version-managers)

### Raspberry Pi and embedded devices

To build and package an Elixir application, with the whole operating system, and burn that into a disk or deploy it overwhere, [check out the Nerves project](https://www.nerves-project.org).
Expand Down Expand Up @@ -149,9 +140,19 @@ iex.bat

You may want to [set the $PATH environment variable](#setting-path-environment-variable) for your whole system. Use `install.sh --help` or `install.bat --help` to learn more about available arguments and options.

## Version managers

There are many tools that allow developers to install and manage multiple Erlang and Elixir versions. They are useful if you have multiple projects running on different Elixir or Erlang versions, can't install Erlang or Elixir as mentioned above or if the version provided by your package manager is outdated. Here are some of those tools:

* [asdf](https://asdf-vm.com) - install and manage different [Elixir](https://github.com/asdf-vm/asdf-elixir) and [Erlang](https://github.com/asdf-vm/asdf-erlang) versions
* [mise](https://mise.en.dev) - install and manage different Elixir and Erlang versions
* [kerl](https://github.com/kerl/kerl) - install and manage different Erlang versions

Keep in mind that each Elixir version supports specific Erlang/OTP versions. [See the supported versions alongside our docs](/docs).

## Precompiled package

Elixir provides a precompiled package for every release. First [install Erlang](/install.html#installing-erlang) and then download the appropriate precompiled Elixir below. You can consult your Erlang/OTP version by running `erl -s halt`:
Elixir provides a precompiled package for every release. First [install Erlang](#installing-erlang) and then download the appropriate precompiled Elixir below. You can consult your Erlang/OTP version by running `erl -s halt`:

{% for otp_version in stable.otp_versions %}
* [Elixir {{ stable.version }} on Erlang/OTP {{ otp_version }}](https://github.com/elixir-lang/elixir/releases/download/v{{ stable.version }}/elixir-otp-{{ otp_version }}.zip){% endfor %}
Expand All @@ -178,18 +179,18 @@ For a list of all builds, use:

## Compiling from source

You can download and compile Elixir in few steps. The first one is to [install Erlang](/install.html#installing-erlang). You will also need [make](https://www.gnu.org/software/make/) available.
You can download and compile Elixir in few steps. The first one is to [install Erlang](#installing-erlang). You will also need [make](https://www.gnu.org/software/make/) available.

Next you should download source code ([.zip](https://github.com/elixir-lang/elixir/archive/v{{ stable.version }}.zip), [.tar.gz](https://github.com/elixir-lang/elixir/archive/v{{ stable.version }}.tar.gz)) of the [latest release](https://github.com/elixir-lang/elixir/releases/tag/v{{ stable.version }}), unpack it and then run `make` inside the unpacked directory (note: if you are running on Windows, [read this page on setting up your environment for compiling Elixir](https://github.com/elixir-lang/elixir/wiki/Windows)).

After compiling, you are ready to run the elixir and `iex` commands from the bin directory. It is recommended that you [add Elixir's bin path to your PATH environment variable](#setting-path-environment-variable) to ease development.

In case you are feeling a bit more adventurous, you can also compile from main:

```bash
$ git clone https://github.com/elixir-lang/elixir.git
$ cd elixir
$ make clean compile
```sh
git clone https://github.com/elixir-lang/elixir.git
cd elixir
make clean compile
```

## Installing Erlang
Expand All @@ -214,7 +215,7 @@ On Windows, there are [instructions for different versions](http://www.computerh

On Unix systems, you need to [find your shell profile file](https://unix.stackexchange.com/a/117470/101951), and then add to the end of this file the following line reflecting the path to your Elixir installation:

```bash
```sh
export PATH="$PATH:/path/to/elixir/bin"
```

Expand Down