# plausible

*Status:* Work in progress

<!-- metadata -->
* **Category**: Apps
* **Status**: 1, alpha
* **Image**: [`plausible/analytics`](https://hub.docker.com/plausible/analytics), 4, upstream
* **Healthcheck**:
* **Backups**: Yes
* **Email**: No
* **Tests**:
* **SSO**: No
<!-- endmetadata -->

## Basic usage

1. Set up Docker Swarm and [`abra`]
2. Deploy [`coop-cloud/traefik`]
3. `abra app new ${REPO_NAME} --secrets` (optionally with `--pass` if you'd like
   to save secrets in `pass`)
4. `abra app config YOURAPPDOMAIN` - be sure to change `$DOMAIN` to something that resolves to
   your Docker swarm box
5. `abra app deploy YOURAPPDOMAIN`
6. Open the configured domain in your browser to finish set-up

## Postgres upgrades

The `db` service uses the
[`pgautoupgrade`](https://github.com/pgautoupgrade/pgautoupgrade) image, so when
the recipe bumps the Postgres major version the existing cluster is upgraded in
place automatically on the next `deploy` — no manual migration steps. As with
any major database upgrade, **take a backup of the `<stack_name>_db` volume
first** (e.g. `abra app backup <domain>`).

[`abra`]: https://git.coopcloud.tech/coop-cloud/abra
[`coop-cloud/traefik`]: https://git.coopcloud.tech/coop-cloud/traefik