# mila

>  Simple, usable, self-hostable membership management for small to mid-sized organizations such as clubs or associations.

<!-- metadata -->

* **Category**: Apps
* **Status**: 0
* **Image**: [`mila`](https://git.local-it.org/local-it/mitgliederverwaltung), 4, upstream
* **Healthcheck**: Yes
* **Backups**: Yes
* **Email**: Yes (optional, via SMTP)
* **Tests**: No
* **SSO**: Yes (optional, via OIDC)

<!-- endmetadata -->

## Quick start

* `abra app new mila --secrets`
* `abra app config <app-name>`
* `abra app deploy <app-name>`

## OIDC Configuration (optional)

To enable OIDC authentication, add the following to your app configuration:

```bash
COMPOSE_FILE="$COMPOSE_FILE:compose.oidc.yml"
OIDC_CLIENT_ID=mila
OIDC_BASE_URL=https://auth.example.com/application/o/mila
OIDC_REDIRECT_URI=https://mila.example.com/auth/user/rauthy/callback
SECRET_OIDC_CLIENT_SECRET_VERSION=v1
```

Then generate the OIDC secret:
```bash
abra app secret generate <app-name> oidc_client_secret v1
```

Optional: set `OIDC_ONLY=true` to show only the SSO button on the login page (hide password form).

## SMTP (optional)

To enable outgoing mail, add `compose.smtp.yml` and set SMTP variables (see `.env.sample`). Generate the SMTP password secret:

```bash
abra app secret generate <app-name> smtp_password v1
```

For more, see [`docs.coopcloud.tech`](https://docs.coopcloud.tech).