From 4d77a2e48a85d002e26abe8c55352186fb40d752 Mon Sep 17 00:00:00 2001 From: Moritz Date: Fri, 23 Aug 2024 16:41:17 +0200 Subject: [PATCH] Update README --- README.md | 30 ++++++++++++++++++++++++++---- 1 file changed, 26 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 1188331..66c0570 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,17 @@ # zammad -> One line description of the recipe +Zammad is a free helpdesk or issue tracking system. * **Category**: Apps * **Status**: 0 * **Image**: [`zammad`](https://hub.docker.com/r/zammad), 4, upstream -* **Healthcheck**: No +* **Healthcheck**: Yes * **Backups**: No -* **Email**: No +* **Email**: Yes * **Tests**: No -* **SSO**: No +* **SSO**: Yes @@ -21,6 +21,28 @@ if using elasticsearch, set on your host: `vm.max_map_count=262144` in `/etc/sy * `abra app new zammad --secrets` * `abra app config ` +* `abra app secret insert smtp_password v1 ` +* `abra app secret generate -a ` * `abra app deploy ` +Either use the web wizard for the initial setup or run: `abra app cmd zammad-railsserver init` + +## Authentik SSO + +* `abra app config ` +``` +SSO_PROVIDER_DOMAIN=authentik.example.com +IDP_SSO_TARGET_URL=https://authentik.example.com/application/saml/zammad/sso/binding/init/ +IDP_SLO_SERVICE_URL=https://authentik.example.com/application/saml/zammad/slo/binding/redirect/ +``` +Run: +`abra app cmd --local enable_authentik_sso` + +## Useful Commands + +Show changed settings: `abra app cmd zammad-railsserver get_setting_changes` + +Open rails console: `abra app cmd zammad-railsserver console` + + For more, see [`docs.coopcloud.tech`](https://docs.coopcloud.tech).