Skip to content

Latest commit

 

History

History
30 lines (21 loc) · 1000 Bytes

README.md

File metadata and controls

30 lines (21 loc) · 1000 Bytes

pkgx - Easy packaging of Erlang releases

This program can be used to make OS packages for an Erlang application bundled as an OTP release.

Requires devscripts and debhelper to be installed on the debian build machine.

Getting started

Create a pkgx.config in the root of your project. Look at the pkgx.config.sample file for instpiration. Also, make sure that you're all set with generating a release using the relx tool.

Typical workflow scenario:

$> rebar compile
$> relx release
$> pkgx deb

Now, you have a *.deb file in your directory which holds the Erlang release and can be easily installed on a target system.

The service will automatically start (using an init.d script), and runs under a new user account. Log files are found in /var/log/(package). A default, empty, config file is created in /etc/(package)/(package).config, from which application environment variables are read from.