generated from coop-cloud/example
50 lines
1.6 KiB
Markdown
50 lines
1.6 KiB
Markdown
# writefreely
|
|
|
|
> An open source platform for building a writing space on the web.
|
|
|
|
<!-- metadata -->
|
|
|
|
* **Category**: Apps
|
|
* **Status**: 2, beta
|
|
* **Image**: [`writefreely`](https://git.coopcloud.tech/coop-cloud-chaos-patchs/docker-writefreely), 1, Co-op Cloud custom image
|
|
* **Healthcheck**: 3
|
|
* **Backups**: 1
|
|
* **Email**: 3
|
|
* **Tests**: No
|
|
* **SSO**: 1
|
|
|
|
<!-- endmetadata -->
|
|
|
|
## Basic usage
|
|
|
|
1. Set up Docker Swarm and `abra`
|
|
2. Deploy `coop-cloud/traefik`
|
|
3. `abra app new writefreely`
|
|
4. `abra app config <domain>` - be sure to change `<domain>` to something that resolves to
|
|
your coop-cloud server.
|
|
- For more info about the config options, see the [writefreely docs](https://writefreely.org/docs/main/admin/config).
|
|
5. `abra app deploy <domain>`
|
|
6. Once it's running, if you are not using SSO, set up a local admin user by running this command:
|
|
|
|
```
|
|
abra app run <domain> app -- writefreely -c /usr/share/writefreely/config.ini user create --admin <some-username>:<some-password>
|
|
```
|
|
|
|
## Keycloak setup
|
|
|
|
For the **OAUTH_HOST** config, it uses this format: `https://keycloak.example.com/auth/realms/<your realm>/protocol/openid-connect`.
|
|
|
|
To set the client secret: `abra app secret insert <domain> oauth_client_secret v1`
|
|
|
|
## MariaDB
|
|
|
|
By default, this recipe uses sqlite. If you wish to use MariaDB instead:
|
|
|
|
1. When creating the app, you need the `--secrets` flag: `abra app new writefreely --secrets`
|
|
2. Run `abra app config <domain>` and follow the instructions to uncomment four lines.
|
|
3. `abra app deploy <domain>`
|
|
|
|
## Acknowledgements
|
|
|
|
Thanks to [@knoflook](https://git.coopcloud.tech/knoflook) for packaging work :heart:
|