A step-by-step guide to install Decidim on a production site
Switch branches/tags
Nothing to show
Clone or download


Installing Decidim

A easy guide to install Decidim, which is a participatory democracy framework created in Ruby on Rails.

It's a very interesting piece of software but it may be challenging to install it if you are not familiar with the internals.

Here I'll make a step-by-step guide on how to install it on production into a machine with Ubuntu 18.04.

I've made this guide because it can be quite challenging to install Decidim in production (as there's currently not much official documentation covering this). This guide also covers some common problems you may face during the process.

Start here:

  1. Installing Decidim on Ubuntu 18.04
    This will guide you to the process of install Decidim in a clean machine and getting it up an running.
  2. Minimal configuration of Decidim
    This part is to configure the 3 extra aspects required run Decidim appropriately. Configure Email sending, SSL security in your server and OAuth authentication.
  3. Installing in Amazon AWS with ElasticBeanstalk
    An alternative guide to install Decidim in Amazon AWS. This is a Heroku-like PaaS deployment sistem. It auto-scales servers if needed and it may be a little cheaper than heroku.
  4. Advanced config & tricks
    A work in progress file to document some common issues and how to solve it.

Feel free to create issues or pull requests if you encounter errors or want to make improvements in this guide!

Official resources

Ivan Vergés
Twitter @ivanverges

@Thanks to
Robert Garrigós for testing and point improvements to this guide, Guillem Marpons and the rest of the Decidim team for their encouragement and support.

AGPL 3.0