Skip to content
A Rebar Archive Packaging Plugin
Erlang Shell
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Rebar Dist Plugin

This plugin allows you to package up a (configurable) set of files into a compressed archive (i.e. .tar.gz or .zip). The plugin's rebar configuration supports wildcards in both relative and absolute paths for files and directories, output path/file name and will allow you to make multiple files if so required.

The plugin exports a new dist command, an will also run in response to the generate and clean commands, although this behaviour is configurable (e.g. if you wish to ignore the generate command and only run when dist is explicitly given on the command line).


Include the following tuple in your rebar deps:

{deps, [{rebar_dist_plugin, ".*", {git,
    "git://", "master"}}]}.

Then you will be able to fetch and install the plugin (locally) with rebar:

user@host$ rebar get-deps compile
user@host$ rebar dist skip_deps=true

Alternatively, you may put the plugin into your ERL_LIBS path somewhere and use it in many projects. This can be done manually, or using a package manager:

user@host$ epm install hyperthunk/rebar-dist-plugin  # or
user@host$ sutro install hyperthunk/rebar-dist-plugin


Configure the dist plugin in your rebar.config as usual:

{rebar_plugins, [rebar_dist_plugin]}.
{dist, [Options]}.

See the wiki for details on the various options (and commands).

You execute the plugin like any other rebar command:

rebar clean generate    # if you're hooked into a release
rebar distclean dist    # if you wish to explicitly assemble a distribution

Running the tests

The project ships with a Makefile wrapper that will execute a bunch of tests against the examples directory using the rebar_retest_plugin. As this configuration has separate dependencies (for test only), the simplest way to run these is to execute make test on the command line.

Something went wrong with that request. Please try again.