50 lines
2.1 KiB
Markdown
50 lines
2.1 KiB
Markdown
# Loomio
|
|
|
|
"Loomio is a collaborative decision-making tool that makes it easy for anyone to participate in decisions which affect them. To find out more, visit Loomio.org."
|
|
|
|
<!-- metadata -->
|
|
* **Category**: Apps
|
|
* **Status**: 3, work-in-progress
|
|
* **Image**: [`loomio/*`](https://hub.docker.com/r/loomio), 4, upstream
|
|
* **Healthcheck**: Yes
|
|
* **Backups**: Yes
|
|
* **Email**: Outgoing yes, incoming no
|
|
* **Tests**: No
|
|
* **SSO**: No
|
|
<!-- endmetadata -->
|
|
|
|
## Basic usage
|
|
|
|
* `abra app new loomio --secrets ` (optionally with `--pass` if you'd like to save secrets in `pass`)
|
|
* `abra app config <app-name>`
|
|
* insert your smtp password with `abra app secret insert <app-name> smtp_password v1 "<your-password>"`
|
|
* `abra app deploy <app-name>`
|
|
* Open the configured domain in your browser to create your user account (only works in case mail is configured correctly)
|
|
* Give yourself admin rights by running `abra app cmd <app-name> app make_last_user_admin`
|
|
* Deploy [swarm-cronjob](https://recipes.coopcloud.tech/swarm-cronjob) on your server if it is not running yet. This is needed for loomios cron container to be started to do hourly chores.
|
|
|
|
## Migration guide
|
|
|
|
### Upgrading to 4.0.0+v2.25.3 and later
|
|
|
|
* Before upgrading to `4.0.0+v2.25.3` and later, one successful deployment of `3.0.0+v2.25.3` shall be performed. Doing both at the same time will lead to complications as 3.0.0 runs rails DB migrations and 4.0.0 upgrades the postgres DB version.
|
|
|
|
### Broken releases
|
|
|
|
Please do not use these releases, as they are having issues regarding database migrations:
|
|
|
|
* 1.0.0+v2.25.2
|
|
* 2.0.0+v2.25.3
|
|
* 2.1.0+v2.25.3
|
|
|
|
### Manual migration steps when upgrading from 0.6.0+v2.25.2 and earlier to 1.0.0+v2.25.2 and later
|
|
|
|
* adapt your env file with the new vars, especially SECRET_DB_PASSWORD_VERSION=v1 and SECRET_SMTP_PASSWORD_VERSION=v1
|
|
* insert your smtp password with `abra app secret insert <app-name> smtp_password v1 "<your-password>"`
|
|
* `abra app secret generate <app-name> db_password v1`
|
|
* `abra app deploy <app-name>`
|
|
* set the new password in DB: `abra app cmd <app-name> db set_new_db_password`
|
|
* redeploy if necessary
|
|
|
|
For more, see [docs.coopcloud.tech](https://docs.coopcloud.tech).
|