---
title: 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](./mailcow1.png)

2. Click "Add OAuth2 Client"

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

![Add OAuth2 Client](./mailcow2.png)

4. Copy the **Client ID** and **Client secret** and _save it for later_

![ClientID and Secret](./mailcow3.png)

## authentik

5. Under _Directory -> Federation & Social login_ Click **Create > Mailcow OAuth Source**

![Mailcow OAuth Source](./mailcow4.png)

6. **Name:** Choose a name (For the example I used Mailcow)
7. **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.)
8. **Consumer Key:** Client ID from step 4
9. **Consumer Secret:** Client Secret from step 4
10. **Authorization URL:** https://mailcow.company/oauth/authorize
11. **Access token URL:** https://mailcow.company/oauth/token
12. **Profile URL:** https://mailcow.company/oauth/profile

Here is an example of a complete authentik Mailcow OAuth Source

![](./mailcow5.png)

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](../../index.md#add-sources-to-default-login-page).
:::
