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.
Download a nightly binary 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 setlocal set rebarscript=%~f0 escript.exe "%rebarscript:.cmd=%" %*
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