aboutsummaryrefslogblamecommitdiffstats
path: root/README.md
blob: ba4b3913fb9e2683ab57d5ec8335566c0cec793d (plain) (tree)
1
2
3
4
5
6
7
8
9
                                                                                                                       
 

       
 
                               
 

        
 
                                               
 

           
 
                                                                  


                                                                   
                                                         



                                                                   

        
 
                                                           
 
          
 
                                   
 






























                                                                                                                                        
 
                                                 
[![Build Status](https://drone.io/github.com/erlware/relx/status.png)](https://drone.io/github.com/erlware/relx/latest)

Relx
=======

A release assembler for Erlang.

Synopsis
--------

relx [*options*] [*release-specification-file*]

Description
-----------

Relx assembles releases for an Erlang/OTP release. Given a release
specification and a list of directories in which to search for OTP
applications it will generate a release output. That output depends
heavily on what plugins available and what options are defined, but
usually it is simply a well configured release directory.

The *release-specification-file* is optional but otherwise contains
additional specification information for releases.

Building
--------

To build relx and generate a standalone escript executable:

    $ make

This creates the executable `relx`.

Config File
-----------

By default `relx` looks for `relx.config` in the current working directory:

```erlang
{release, {relname, "vsn"},
 [app1,
  app2]}.

{extended_start_script, true}.
```

Options
-------

| Short | Long         | Type    | Default | Description                                                                               |
|:-----:|:------------:|:-------:|:------:|------------------------------------------------------------------------------------------- |
| -r    | --root       | string  | ./      | Name for the release that will be generated |
| -v    | --relvsn     | string  |         | Version for the release |
| -g    | --goal       | string  |         | A goal for the system. These are usually the OTP apps that are part of the release |
| -u    | --upfrom     | string  |         | The release to upgrade from. Only valid with relup target |
| -o    | --output-dir | string  | ./      | The output directory for the release |
| -l    | --lib-dir    | string  |         | Additional dirs to search for OTP apps |
|       | --disable-default-libs | boolean | false | Disable use of the default system added lib dirs |
| -V    | --verbose    | integer | 0       | The verbosity level between 0 and 2 |
| -a    | --override_app | string | | An app name and a directory to override in the form appname:dir |
| -c    | --config     | string  | ./relx.config | Config file path |

Wiki
----

[relx wiki](https://github.com/erlware/relx/wiki)