Manual installation tutorial
In order to develop on decidim, you’ll need:
Chrome browser and chromedriver.
We’re starting with an Ubuntu 20.04 LTS. This is an opinionated guide, so you’re free to use the technology that you are most comfortable. If you have any doubts and you’re blocked you can go and ask on our Gitter.
We recommend to have at least some basic proficiency in Ruby on Rails (a good starting point is Getting Started with Ruby on Rails) and have some knowledge on how gems work.
In this guide, we’ll see how to install rbenv, PostgreSQL and, Decidim, and how to configure everything together.
sudo apt update sudo apt install -y build-essential git libssl-dev zlib1g-dev git clone https://github.com/rbenv/rbenv.git ~/.rbenv echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc echo 'eval "$(rbenv init -)"' >> ~/.bashrc source ~/.bashrc git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build rbenv install 2.7.1 rbenv global 2.7.1
Now we’re going to install PostgreSQL for the database:
sudo apt install -y postgresql libpq-dev sudo -u postgres psql -c "CREATE USER decidim_app WITH SUPERUSER CREATEDB NOCREATEROLE PASSWORD 'thepassword'"
You need to change the password (in this example is "thepassword") and save it somewhere to configure it later with the application.
Next, we need to install the
decidim gem with its dependencies:
sudo apt install -y libicu-dev nodejs imagemagick gem install decidim
Then we can create an application with the
decidim executable, where
decidim_application is your application name (ie DecidimBarcelona):
decidim decidim_application cd decidim_application
We recommend that you save it all on Git.
git add . git commit -m "Initial commit. Generated with Decidim https://decidim.org"
Modify your secrets (see
config/database.yml). For this you can use figaro, dotenv or rbenv-vars. You should always be careful of not uploading your plain secrets on git or your version control system. You can also upload the encrypted secrets, using the sekrets gem or if you’re on Ruby on Rails greater than 5.1 you can do it natively.
For instance, for working with figaro, add this to your
Then install it:
bundle install bundle exec figaro install
Next, add this to your
config/application.yml, using the setup PostgreSQL database name, user and, password that you’ve configured before.
DATABASE_HOST: localhost DATABASE_USERNAME: decidim_app DATABASE_PASSWORD: thepassword
Finally, save it all to git:
git add . git commit -m "Add figaro configuration management"
We should now create your database:
bin/rails db:create db:migrate bin/rails db:seed
This will also create some default data so you can start testing the app, with an administrator account with email firstname.lastname@example.org and password
You can now start your server!
Visit http://localhost:3000 to see your app running. 🎉 🎉
With these steps you would only have an initial installation for trying Decidim, but it still needs lots of things to take in account. If you want a working production system then we recommend that you follow the Decidim Install guide by Platoniq.
Other user accounts that you’ll have in the seeds are:
To participate as a regular user, with email
To manage the Multitenant and being able to log in at
/system, with email
The seed data won’t be created in production environments, if you still want to do it (for instance, for a Demo or Staging server), run:
SEED=true rails db:seed