Skip to content

Upgrade from exrm to distillery as build tool

Marc Schwieterman edited this page Aug 12, 2016 · 10 revisions

Distillery is a new release tool for elixir applications and will replace exrm in the future. It builds releases faster, is written in elixir, more configurable and it's goal is to become a part of mix itself as the standard tooling for elixir releases. Switching to distillery as release tool requires the following steps:

  • remove :exrm as dependency from your mix.exs file
  • add distillery as dependency to your mix.exs file
defp deps do
  [ ...
    {:distillery, ">= 0.9.0", warn_missing: false},
    {:edeliver, ">= 1.4.0"},
  ]
end
  • ensure that you are using edeliver version >= 1.4.0
  • run mix do deps.clean --unlock --unused, deps.get, deps.compile
  • create initial config by running mix release.init
  • edit the config at rel/config.exs, according to the distillery documentation
  • remove the rel dir from your .gitignore and add rel/<your-apps>
  • add the configuration file and changed .gitignore to your repository
  • convert existing exrm plugins to distillery plugins

For umbrella projects it might be required that some paths need to be adjusted because releases are built and generated at the root folder of the project now. In addition all umbrella releases are built separately by default, but they can be built into a single release if desired.

See also closed issue #128.

Clone this wiki locally