Skip to main content

Mailcow

Support level: Community

Allows users to authenticate using their Mailcow credentials

Preparation​

The following placeholders are used in this guide:

  • authentik.company is the FQDN of the authentik installation.
  • mailcow.company is the FQDN of the mailcow installation.

Mailcow​

  1. Log in to mailcow as an admin and navigate to the OAuth2 Apps settings

OAuth2 Apps menu

  1. Click "Add OAuth2 Client"

  2. Insert the redirect URL: https://authentik.company/source/oauth/callback/mailcow/

Add OAuth2 Client

  1. Copy the Client ID and Client secret and save it for later

ClientID and Secret

authentik​

  1. Under Directory -> Federation & Social login Click Create > Mailcow OAuth Source

Mailcow OAuth Source

  1. Name: Choose a name (For the example I used Mailcow)
  2. Slug: mailcow (You can choose a different slug, if you do you will need to update the Mailcow redirect URL and point it to the correct slug.)
  3. Consumer Key: Client ID from step 4
  4. Consumer Secret: Client Secret from step 4
  5. Authorization URL: https://mailcow.company/oauth/authorize
  6. Access token URL: https://mailcow.company/oauth/token
  7. Profile URL: https://mailcow.company/oauth/profile

Here is an example of a complete authentik Mailcow OAuth Source

Save, and you now have Mailcow as a source.

note

For instructions on how to display the new source on the authentik login page, refer to the Add sources to default login page documentation.