Downloading and installing a pre-built beamruntime tarball

In order to use beamruntime, it is necessary to download and run a pre-built beamruntime installer. The following steps describe a full setup session:

note

meta-erlang provides recipes for more than one Erlang/Elxir releases. Each beamruntime release is made with the latest Erlang and Elixir versions. Check the beamruntime release page to get an overview of the available versions.

1. From the beamruntime release page, locate and download the *.sh

2. Execute the installation script. Here is an example for the usual installer:

   sh ~/Downloads/x86_64-beamruntime-nativesdk-standalone-5.2.99+snapshot-3c1ef0d520273835f89981bb336ce9dd6e23b9fd-glibc-erlang-28.0.4-elixir-1.18.4.sh

   The installation script is going to ask the destination path. You are free to use whatever path you need.

   note

   During execution, a prompt appears that allows you to choose the installation directory. For example, you could choose the following: /home/your-username/beamruntime

   The follow lines show the full output for beamruntime installation process:

   joaohf@porco:~/$ sh ~/Downloads/x86_64-beamruntime-nativesdk-standalone-5.2.99+snapshot-3c1ef0d520273835f89981bb336ce9dd6e23b9fd-glibc-erlang-28.0.4-elixir-1.18.4.sh
   BEAM tools installer version 5.2.99-erlang-28.0.4-elixir-1.18.4
   ==============================================================
   Enter target directory for SDK (default: /opt/beamruntime/5.2.99-erlang-28.0.4-elixir-1.18.4): /home/joaohf/beamruntime/5.2.99-erlang-28.0.4-elixir-1.18.4
   You are about to install the SDK to "/home/joaohf/beamruntime/5.2.99-erlang-28.0.4-elixir-1.18.4". Proceed [Y/n]?
   Extracting SDK.....................................done
   Setting it up...done
   SDK has been successfully set up and is ready to be used.
   Each time you wish to use the SDK in a new shell session, you need to source the environment setup script e.g.
   $ . /home/joaohf/beamruntime/5.2.99-erlang-28.0.4-elixir-1.18.4/environment-setup-x86_64-pokysdk-linux

3. Source the tools environment setup script by using a command like the following:

   source /home/your_username/beamruntime/5.2.99-erlang-28.0.4-elixir-1.18.4/environment-setup-x86_64-pokysdk-linux

   After you have sourced the setup script configured the PATH environment variable and any other environment variables required to run the tools are initialized.

   The current shell has the environment variable configured to the correct Erlang and Elixir installation. And running: erl or iex gives you an Erlang and Elixir prompts.

   note

   For each new shell, it will be necessary to source the environment-setup-x86_64-pokysdk-linux file.