38 lines
1.2 KiB
Markdown
38 lines
1.2 KiB
Markdown
# 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
|