Go to file
marlon 27faf7a644
Some checks failed
continuous-integration/drone/push Build is failing
add release notes
2025-02-11 15:16:22 -05:00
release add release notes 2025-02-11 15:16:22 -05:00
.drone.yml Update .drone.yml 2025-01-08 10:09:13 -08:00
.env.sample add env 2025-02-10 17:51:32 -05:00
.gitignore Working docker-compose.yml 2021-11-24 16:54:45 +01:00
abra.sh reload mattermost config using mmctl. Fix readme typo 2025-02-11 15:07:18 -05:00
compose.email.yml add config reset command 2025-02-10 18:14:12 -05:00
compose.sso.yml sso support wip 2025-02-10 13:32:14 -05:00
compose.yml sso support wip 2025-02-10 13:32:14 -05:00
config.json.tmpl reload mattermost config using mmctl. Fix readme typo 2025-02-11 15:07:18 -05:00
entrypoint.sh sso support wip 2025-02-10 13:32:14 -05:00
gitlab_config_patch.json.tmpl working on sso support 2025-02-09 14:47:02 -05:00
README.md reload mattermost config using mmctl. Fix readme typo 2025-02-11 15:07:18 -05:00

mattermost

Basic usage

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

Enable Email

WARNING: Following these steps will overwrite the configuration of your Mattermost instance. Probably only run it on a fresh deployment.

  • abra app config YOURAPPNAME
  • Uncomment the section starting with Email Support
  • abra app secret i YOURAPPNAME smtp_pass v1 'yourSMTPpassword'
  • abra app undeploy YOURAPPNAME
  • abra app deploy YOURAPPNAME
  • abra app command -C YOURAPPNAME app reset_config <- This will overwrite your configuration

Enable SSO with Authentik

This is how to configure your Mattermost server to accept logins from your Authentik SSO provider.

Configure Authentik

Create a property mapping

  • Log in as administrator of your Authentik instance
  • Go to https://authentik.yourserver.org/if/admin/#/core/property-mappings and choose Create
  • Choose Scope Mapping
    • Name: Mattermost ID
    • Scope Name: id
    • Description: optional own description
    • Expression: return { "id": request.user.id }
  • Create another Scope Mapping
    • Name: Mattermost Username
    • Scope Name: username
    • Description: optional own description
    • Expression: return { "username": request.user.username }

Create Application and Provider

Configure Mattermost

WARNING: Following these steps will overwrite the configuration of your Mattermost instance. Probably only run it on a fresh deployment.

  • abra app configure YOURAPPNAME
    • Uncomment the section starting with ## SSO config
    • Set SSO_ID to the value you saved when configuring Authentik
  • abra app secret insert YOURAPPNAME mattermost_sso_secret v1 <the authentik provider secret you saved>
  • abra app undeploy YOURAPPNAME
  • abra app deploy YOURAPPNAME
  • abra app command -C YOURAPPNAME app reset_config <- This will overwrite your configuration

Disable non-SSO login (Optional)