We attempt very limited backwards compatibility with previous rebar versions' configurations and will try to call out important changes in the documentation.
Install Erlang as you usually would; rebar3 does not bundle it. People using Windows can get the binaries from erlang.org, and most linux or unix-like distributions can get those from package managers. OSX is fine with Homebrew.
Debian and Ubuntu derivatives have a history of having broken up the Erlang standard release into sub-libraries packages that are not all installed by default and will end up with missing packages compared to other installs. Be sure to install the extra Erlang packages and development packages for everything to work fine, or switch to one of the methods for source installs.
At present the Erlang installer does not create a PATH entry. For users unaware of how to create this, you may need local or network administrator permissions.
- open a file explorer window
- right-click "This PC" which appears in the left-hand side menu
- left click "Properties" in the menu that appears
- left-click "Advanced system settings" in the new window
- left-click on Environment Variables at the bottom of the new window
- Scroll to "Path", "path" or "PATH" and left click that line
- left-click "Edit..."
- Add two entries
- C:\Program Files\erl10.5\bin
- download and install erlang binary
- download rebar3
- make a
binfolder in your %USERPROFILE% directory.
this can be reached using the bar which tells you where you are in an explorer window, replacing content with
%USERPROFILE%and pressing the return key. From there right-click and create a new folder
- copy rebar3 file to %USERPROFILE%\bin
- make a file using notepad.exe with the contents of the .cmd invoker for escript to run rebar3 (provided in this document below)
- open a new command-line and type rebar3
Download the binary of the latest stable version here. Ensure it is executable (
chmod +x) and simply copy to a directory in your
It is common to create a directory
~/bin/ to place commands like
rebar3 and add it to your path with
export PATH=~/bin/:$PATH in your
~/.zshrc or equivalent.
Windows users who want to use the code from PowerShell or cmd.exe (rather than a terminal emulator) must ensure that a
rebar3.cmdfile is added:
@echo off escript.exe "%~dpn0" %*
The source installation that follows creates the file automatically.
$ git clone https://github.com/erlang/rebar3.git $ cd rebar3 $ ./bootstrap
And now you have the script
rebar3 and can copy it to somewhere in your
$PATH as described in the previous section. Windows users should also include the
rebar3.cmd for the util to work in PowerShell or cmd.exe.
An additional way to install and run rebar3 can be found under the
rebar3 local install will extract the contents of the escript to
~/.cache/rebar3/lib and create a shell script
$ ./rebar3 local install ===> Extracting rebar3 libs to ~/.cache/rebar3/lib... ===> Writing rebar3 run script ~/.cache/rebar3/bin/rebar3... ===> Add to $PATH for use: export PATH=$PATH:~/.cache/rebar3/bin
rebar3 local upgrade will fetch the latest stable escript from s3 and install the same way:
$ rebar3 local upgrade ===> Extracting rebar3 libs to ~/.cache/rebar3/lib... ===> Writing rebar3 run script ~/.cache/rebar3/bin/rebar3... ===> Add to $PATH for use: export PATH=$PATH:~/.cache/rebar3/bin
$ rebar3 new release myrelease ===> Writing apps/myrelease/src/myrelease_app.erl ===> Writing apps/myrelease/src/myrelease_sup.erl ===> Writing apps/myrelease/src/myrelease.app.src ===> Writing rebar.config ===> Writing config/sys.config ===> Writing config/vm.args ===> Writing .gitignore ===> Writing LICENSE ===> Writing README.md
Continue on to Basic Usage to learn more on how to use
Updated 11 months ago