# liberaforms

> Ethical form software

<!-- metadata -->

- **Category**: Apps
- **Status**: wip
- **Image**: [`liberaforms`](https://fung.uy/mycosystems/-/packages/container/liberaforms/), 1
- **Healthcheck**: Yes
- **Backups**: Yes
- **Email**: 1
- **Tests**: Yes
- **SSO**: 3

<!-- endmetadata -->

## Quick start

- `abra app new liberaforms`
- Generate secrets 
    - `abra app secret g <domain-name> secret_key v1`
    - `abra app secret g <domain-name> db_password v1`
- Set an admin email address `abra app config <domain-name>`
- `abra app deploy <domain-name>`
- Create tables `abra app cmd <domain-name> forms setup_db` more info in [liberaforms docs](https://codeberg.org/LiberaForms/server/src/branch/main/docs/docker.md#create-the-database)
- Generate keypair used to sign form entries/uploads `abra app cmd <domain-name> forms gen_key`
- Insert the key `abra app secret i forms.fung.uy crypto_key v1 <key>`
- Re-deploy

## Admin account setup

Once liberaforms is deployed, go to the login screen by clicking the text in the top right. Next, click "forgot password" now you can fill in the email you set as your admin email and you will be prompted to set a password.

For more, see [`docs.liberaforms.org`](https://docs.liberaforms.org/).