Skip to content

Commit 512ba80

Browse files
author
Aman Shah
committed
Added the wiki to setup keycloak and shared mailbox in mailcow
1 parent 2ee6669 commit 512ba80

File tree

10 files changed

+46
-0
lines changed

10 files changed

+46
-0
lines changed

docs/images/add_alias.png

62.6 KB
Loading

docs/images/alias.png

130 KB
Loading

docs/images/filters.png

20.6 KB
Loading

docs/images/jobs_filter.png

29.4 KB
Loading

docs/images/keycloak.png

139 KB
Loading

docs/images/multiple_folders.png

11.7 KB
Loading

docs/images/shared_folders.png

31.8 KB
Loading

docs/images/shared_keycloack.png

113 KB
Loading

docs/images/sharing.png

35.7 KB
Loading

docs/mailcow.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# Setup Mailserver using Mailcow
2+
3+
## Setup Keycloak in Mailcow
4+
5+
1. To add or edit your Identity Provider configuration, log in to your mailcow UI as administrator, go to System > Configuration > Access > Identity Provider and select Keycloak from the Identity Provider dropdown.
6+
2. Create a `mailcow` client in keycloak
7+
3. Update the fields based on your configurations.
8+
4. An important thing to take care of is in the `Server Url` field, your url must be the keycloak URL followed by /auth like `https://keycloack.test.com/auth`
9+
5. You can enable `Auto-create users on login` which will autocreate your mailbox in the mailcow when you login to your mailserver using keycloak, provided the user is already present and enabled in keycloak.
10+
11+
![](images/keycloak.png)
12+
13+
Notes -
14+
15+
1. If we disable user in keycloak then user won't be able to login to mailcow but will continue getting mails
16+
2. Make mailbox as inactive - if we don't want a user to get mails
17+
3. Once mailbox is deactivated in mailcow - user can't even login to mailcow
18+
19+
## Setup a Shared mailbox in Mailcow
20+
21+
1. Create a shared mailbox in mailcow and login to that.
22+
2. Add delegation for a user - then only you can share the folder and update perms
23+
24+
![](images/shared_folders.png)
25+
26+
3. Once the delegation is added you can start to share it that users.
27+
28+
![](images/sharing.png)
29+
30+
### Shared mailbox with multiple folders
31+
32+
1. You can create multile folders like `info`, `ops`, `jobs` etc in your shared mailbox and then share them across your team.
33+
34+
![](images/multiple_folders.png)
35+
36+
2. You can then write a filter rule so that if mail sent to your `jobs@test.com` it lands to your `jobs` folder.
37+
Click on `Preferences ->Mail -> Filter`
38+
39+
![](images/filters.png)
40+
41+
![](images/jobs_filter.png)
42+
43+
3. You need to create a alias in mailcow so that any mails that gets sent to `jobs@test.com` goes to your shared mailbox like `shared@test.com`.
44+
This you can do by logging as admin in mailcow and then `Email -> Configuration -> Aliases -> Add Alias`
45+
46+
![](images/add_alias.png)

0 commit comments

Comments
 (0)