Migrating to 0.15.x

In version 0.15.0 we refactored the way we address app configuration.

Please read this page carefully if you're upgrading from any previous version.

Breaking changes

Breaking changes with all previous versions have been introduced:

• Configuration variables on .json files written with spaces were changed to camelCase. E.g.: some setting to someSetting.
• Environment variables now should be named exactly the same as the configuration at /config/defaults.json but CONSTANT_CASE. E.g.: mongoUrl should be MONGO_URL and notifications.url should be NOTIFICATIONS_URL.

Note: you can see all available environment variables in Configuring DemocracyOS

Migrating {environment}.json

Now, you're encouraged to override only the values needed, because /config/defaults.json has pretty good default ones.

We recommend to delete/backup your /config/{environment}.json file and run make. It will create a new /config/{environment}.json file just for you. Then you can edit it and re-add all the old variables.

Migrating ENV variables

Here's a list of all the environment variables that were changed (OLD_NAME => NEW_NAME):

• EXTERNAL_SIGNIN_URL => SIGNIN_URL
• EXTERNAL_SIGNUP_URL => SIGNUP_URL
• EXTERNAL_SETTINGS_URL => SETTINGS_URL
• BASIC_USERNAME => AUTH_BASIC_USERNAME
• BASIC_PASSWORD => AUTH_BASIC_PASSWORD
• HTTPS_REDIRECT_MODE => HTTPS_REDIRECT