Skip to main content

Installation

Install the gem on your host application so Decidim keeps owning domain logic; this module only adds the HTTP API surface described in the overview.

Decidim compatibility

DecidimSupported
0.28yes
0.29yes
0.27 and olderno

Install

Add the metagem to your host app Gemfile:

gem "decidim-restfull", "~> 0.3"

Then:

bundle install
bundle add deface
bundle exec rails decidim_rest_full:install:migrations
bundle exec rails db:migrate
bundle exec rails deface:precompile

Host app extensions

Tenant-specific routes (chatbot bridges, legacy paths, one-deployment APIs) can register on the RestFull mount from the host app via Extension.register — no feature gem required. See Host app extensions.

Environment variables

NameDescriptionDefault
DECIDIM_REST_QUEUE_NAMEActive Job queue namedefault
DECIDIM_REST_LOADBALANCER_IPSCSV of load balancer IPs for safe host handling. See Safe host update.127.0.0.1, ::1
DOCS_URLBase URL for generated docshttps://octree-gva.github.io/decidim-rest-full

For capacity planning (Puma, Redis, Sidekiq, k6, client patterns), see Production mode.