erlware/relx

Sane, simple release creation for Erlang

693

stars

1,414

commits

Erlang

primary language

Mar 24, 2026

updated

erlware.github.io/relx

README

Cirrus CI - Task and Script Build Status

Relx

Relx is a library that assembles Erlang/OTP releases. Given a release specification and a list of directories in which to search for OTP applications it will generate a release output.

It is generally used through the Erlang/OTP build tool rebar3 which provides a cli interface.

Documentation

relx is a library used by rebar3. Documentation on using rebar3 for building releases with relx can be found on rebar3.org.

Also see Adopting Erlang's Releases chapter.

Building and Testing

Common Test suites can be run with rebar3:

$ rebar3 compile
$ rebar3 ct

Tests for the start scripts that are generated by relx are tested with shelltestrunner.

The script shelltests/run_tests.sh will clone rebar3 main and build it with the current relx as a checkout dependency and then run the tests using that rebar3 escript:

$ shelltests/run_tests.sh

Contributors

(top 30 of 119)

tsloughter

593 commits

ericbmerritt

187 commits

jwilberding

167 commits

lrascao

129 commits

erlware/relx

Sane, simple release creation for Erlang

693

stars

1,414

commits

Erlang

primary language

Mar 24, 2026

updated

erlware.github.io/relx

README

Cirrus CI - Task and Script Build Status

Relx

Relx is a library that assembles Erlang/OTP releases. Given a release specification and a list of directories in which to search for OTP applications it will generate a release output.

It is generally used through the Erlang/OTP build tool rebar3 which provides a cli interface.

Documentation

relx is a library used by rebar3. Documentation on using rebar3 for building releases with relx can be found on rebar3.org.

Also see Adopting Erlang's Releases chapter.

Building and Testing

Common Test suites can be run with rebar3:

$ rebar3 compile
$ rebar3 ct

Tests for the start scripts that are generated by relx are tested with shelltestrunner.

The script shelltests/run_tests.sh will clone rebar3 main and build it with the current relx as a checkout dependency and then run the tests using that rebar3 escript:

$ shelltests/run_tests.sh

Contributors

(top 30 of 119)

tsloughter

593 commits

ericbmerritt

187 commits

jwilberding

167 commits

lrascao

129 commits

Languages

Erlang

86.0%

Shell

9.1%

PowerShell

4.9%