Install
The quickest way to install Elixir is through a distribution or using one of the available installers. If not available, then we recommend the precompiled packages or compiling it.
Note that Elixir v1.13 requires Erlang 22.0 or later. Many of the instructions below will automatically install Erlang for you. In case they do not, read the “Installing Erlang” section below.
Distributions
The preferred option for installing Elixir. Choose your operating system and tool.
If your distribution contains an old Elixir/Erlang version, see the sections below for installing Elixir/Erlang from version managers or from source.
macOS
GNU/Linux
- Alpine Linux (Community repository)
- Run:
apk add elixir
- Run:
- Arch Linux (Community repository)
- Run:
pacman -S elixir
- Run:
- Debian
- See below the instructions for Ubuntu
- Fedora 21 (and older)
- Run:
yum install elixir
- Run:
- Fedora 22 (and newer)
- Run
dnf install elixir erlang
- Run
- Gentoo
- Run:
emerge --ask dev-lang/elixir
- Run:
- GNU Guix
- Run:
guix package -i elixir
- Run:
- openSUSE (and SLES)
- Add Elixir/Erlang repository:
zypper ar -f obs://devel:languages:erlang/ Elixir-Factory
- Run:
zypper in elixir
- Optional: if you want to use the latest Erlang, you can use this repository:
zypper ar -f obs://devel:languages:erlang:Factory Erlang-Factory
- Add Elixir/Erlang repository:
- Slackware
- Using Sbopkg:
- Run:
sbopkg -ki "erlang-otp elixir"
- Run:
- Manually:
- Download, build and install from SlackBuilds.org:
erlang-otp
, andelixir
- Download, build and install from SlackBuilds.org:
- Using Sbopkg:
- Solus
- Run:
eopkg install elixir
- Run:
- Ubuntu or Debian
- Add Erlang Solutions repository:
wget https://packages.erlang-solutions.com/erlang-solutions_2.0_all.deb && sudo dpkg -i erlang-solutions_2.0_all.deb
- Run:
sudo apt-get update
- Install the Erlang/OTP platform and all of its applications:
sudo apt-get install esl-erlang
- Install Elixir:
sudo apt-get install elixir
- Add Erlang Solutions repository:
- Void Linux
- Run:
xbps-install -S elixir
- Run:
BSD
- FreeBSD
- The latest Elixir release is named lang/elixir-devel. The default Elixir, lang/elixir, may lag slightly as dependent ports are often not able to be updated to the newest Elixir release immediately.
- Using ports:
- Run:
cd /usr/ports/lang/elixir && make install clean
- Run:
- Using pkg:
- Run:
pkg install elixir
orpkg install elixir-devel
- Run:
- OpenBSD
- Run:
pkg_add elixir
- Run:
Windows
- Using our web installer:
- Download the installer
- Click next, next, …, finish
- If you run into issues, check out the Windows Installer issues tracker
- Using Chocolatey:
- Run:
cinst elixir
- Run:
Raspberry Pi
If necessary, replace “buster” with the name of your Raspbian release.
- The Erlang Solutions repository has a prebuilt package for armhf. This saves a significant amount of time in comparison to recompiling natively
- Get Erlang key and add it to the keychain:
- Run:
echo "deb https://packages.erlang-solutions.com/debian buster contrib" | sudo tee /etc/apt/sources.list.d/erlang-solutions.list
- Run:
wget https://packages.erlang-solutions.com/debian/erlang_solutions.asc
- Run:
cat erlang_solutions.asc | gpg --dearmor > erlang_solutions.gpg
- Run:
sudo install -o root -g root -m 644 erlang_solutions.gpg /etc/apt/trusted.gpg.d/
- Run:
- Install Elixir:
- Update apt to latest:
sudo apt update
- Run:
sudo apt install elixir
- Update apt to latest:
Docker
If you are familiar with Docker you can use the official Docker image to get started quickly with Elixir.
- Enter interactive mode
- Run:
docker run -it --rm elixir
- Run:
- Enter bash within container with installed
elixir
- Run:
docker run -it --rm elixir bash
- Run:
The above will automatically point to the latest Erlang and Elixir available. For production usage, we recommend using Hex.pm Docker images, which are immutable and point to a specific Erlang and Elixir version.
Precompiled package
Elixir provides a precompiled package for every release. First install Erlang and then download and unzip the Precompiled.zip file for the latest release.
Once the release is unpacked, you are ready to run the elixir
and iex
commands from the bin
directory, but we recommend you to add Elixir’s bin path to your PATH environment variable to ease development.
Compiling with 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 - install and manage different Elixir and Erlang versions
- exenv - install and manage different Elixir versions
- kiex - install and manage different Elixir versions
- kerl - install and manage different Erlang versions
Keep in mind that each Elixir version supports specific Erlang/OTP versions. Check the compatibility table if you have questions or run into issues.
If you would prefer to compile from source manually, don’t worry, we got your back too.
Compiling from source (Unix and MinGW)
You can download and compile Elixir in few steps. The first one is to install Erlang.
Next you should download source code (.zip, .tar.gz) of the latest release, 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).
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 to ease development.
In case you are feeling a bit more adventurous, you can also compile from main:
$ git clone https://github.com/elixir-lang/elixir.git
$ cd elixir
$ make clean test
If the tests pass, you are ready to go. Otherwise, feel free to open an issue in the issues tracker on GitHub.
Installing Erlang
The only prerequisite for Elixir is Erlang, version 22.0 or later. When installing Elixir, Erlang is generally installed automatically for you. However, if you want to install Erlang manually, you might check:
- Source code distribution and Windows installers from Erlang’s official website
- Precompiled packages for some Unix-like installations
- A general list of installation methods from the Riak documentation.
After Erlang is installed, you should be able to open up the command line (or command prompt) and check the Erlang version by typing erl
. You will see some information similar to:
Erlang/OTP 22.0 [64-bit] [smp:2:2] [...]
Notice that depending on how you installed Erlang, Erlang binaries might not be available in your PATH. Be sure to have Erlang binaries in your PATH, otherwise Elixir won’t work!
Setting PATH environment variable
It is highly recommended to add Elixir’s bin path to your PATH environment variable to ease development.
On Windows, there are instructions for different versions explaining the process.
On Unix systems, you need to find your shell profile file, and then add to the end of this file the following line reflecting the path to your Elixir installation:
export PATH="$PATH:/path/to/elixir/bin"
Checking the installed version of Elixir
Once you have Elixir installed, you can check its version by running elixir --version
.