Skip to content

Commit 4e029bb

Browse files
Merge pull request #801 from mailcow/disable-ipv6-update
Update instructions for disabling IPv6 in nginx
2 parents 96da71b + 36ac7ea commit 4e029bb

File tree

2 files changed

+44
-12
lines changed

2 files changed

+44
-12
lines changed

docs/post_installation/firststeps-disable_ipv6.de.md

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@ Dies wird **NUR** empfohlen, wenn Sie kein IPv6-fähiges Netzwerk auf Ihrem Host
66
Wenn Sie es wirklich brauchen, können Sie die Verwendung von IPv6 in der Compose-Datei deaktivieren.
77
Zusätzlich können Sie auch den Start des Containers "ipv6nat-mailcow" deaktivieren, da er nicht benötigt wird, wenn Sie IPv6 nicht verwenden.
88

9-
Anstatt die Datei docker-compose.yml direkt zu bearbeiten, ist es besser, eine Override-Datei zu erstellen
9+
Anstatt die Datei docker-compose.yml direkt zu bearbeiten, ist es besser, eine Override-Datei zu erstellen
1010
zu erstellen und Ihre Änderungen am Dienst dort zu implementieren. Leider scheint dies im Moment nur für Dienste zu funktionieren, nicht für Netzwerkeinstellungen.
1111

12-
Um IPv6 im mailcow-Netzwerk zu deaktivieren, öffnen Sie docker-compose.yml mit Ihrem bevorzugten Texteditor und suchen Sie nach dem Netzwerk-Abschnitt (er befindet sich am Ende der Datei).
12+
Um IPv6 im mailcow-Netzwerk zu deaktivieren, öffnen Sie docker-compose.yml mit Ihrem bevorzugten Texteditor und suchen Sie nach dem Netzwerk-Abschnitt (er befindet sich am Ende der Datei).
1313

1414
**1.** Ändern Sie docker-compose.yml
1515

@@ -29,7 +29,7 @@ networks:
2929

3030
**2.** ipv6nat-mailcow deaktivieren
3131

32-
Um den ipv6nat-mailcow Container ebenfalls zu deaktivieren, gehen Sie in Ihr mailcow Verzeichnis und erstellen Sie eine neue Datei namens "docker-compose.override.yml":
32+
Um den ipv6nat-mailcow Container ebenfalls zu deaktivieren, gehen Sie in Ihr mailcow Verzeichnis und erstellen Sie eine neue Datei namens "docker-compose.override.yml":
3333

3434
**HINWEIS:** Wenn Sie bereits eine Override-Datei haben, erstellen Sie diese natürlich nicht neu, sondern fügen Sie die untenstehenden Zeilen entsprechend in Ihre bestehende Datei ein!
3535

@@ -116,11 +116,27 @@ Starten Sie Postfix neu:
116116

117117
**5.** Wenn im Docker Daemon IPv6 komplett deaktiviert ist:
118118

119-
Folgende NGINX, Dovecot und Php-fpm Konfigurationsdateien anpassen
119+
Folgende Dovecot und Php-fpm Konfigurationsdateien anpassen
120120

121121
```
122-
sed -i '/::/d' data/conf/nginx/templates/listen*
123-
sed -i '/::/d' data/conf/nginx/dynmaps.conf
124122
sed -i 's/,\[::\]//g' data/conf/dovecot/dovecot.conf
125123
sed -i 's/\[::\]://g' data/conf/phpfpm/php-fpm.d/pools.conf
126124
```
125+
126+
**6.** IPv6 Listener für NGINX deaktivieren
127+
128+
Setze `DISABLE_IPv6=y` in der Datei `mailcow.conf`.
129+
130+
Damit diese Änderung wirksam wird, muss der Container `nginx-mailcow` neu erstellt werden.
131+
132+
=== "docker compose (Plugin)"
133+
134+
``` bash
135+
docker compose up -d
136+
```
137+
138+
=== "docker-compose (Standalone)"
139+
140+
``` bash
141+
docker-compose up -d
142+
```

docs/post_installation/firststeps-disable_ipv6.en.md

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@ This is **ONLY** recommended if you do not have an IPv6 enabled network on your
66
If you really need to, you can disable the usage of IPv6 in the compose file.
77
Additionally, you can also disable the startup of container "ipv6nat-mailcow", as it's not needed if you won't use IPv6.
88

9-
Instead of editing docker-compose.yml directly, it is preferable to create an override file for it
9+
Instead of editing docker-compose.yml directly, it is preferable to create an override file for it
1010
and implement your changes to the service there. Unfortunately, this right now only seems to work for services, not for network settings.
1111

12-
To disable IPv6 on the mailcow network, open docker-compose.yml with your favourite text editor and search for the network section (it's near the bottom of the file).
12+
To disable IPv6 on the mailcow network, open docker-compose.yml with your favourite text editor and search for the network section (it's near the bottom of the file).
1313

1414
**1.** Modify docker-compose.yml
1515

@@ -30,7 +30,7 @@ networks:
3030

3131
**2.** Disable ipv6nat-mailcow
3232

33-
To disable the ipv6nat-mailcow container as well, go to your mailcow directory and create a new file called "docker-compose.override.yml":
33+
To disable the ipv6nat-mailcow container as well, go to your mailcow directory and create a new file called "docker-compose.override.yml":
3434

3535
**NOTE:** If you already have an override file, of course don't recreate it, but merge the lines below into your existing one accordingly!
3636

@@ -116,12 +116,28 @@ Restart Postfix:
116116

117117
**5.** If your docker daemon completly disabled IPv6:
118118

119-
Fix the following NGINX, Dovecot and php-fpm config files
119+
Fix the following Dovecot and php-fpm config files
120120

121121
```
122-
sed -i '/::/d' data/conf/nginx/templates/listen*
123-
sed -i '/::/d' data/conf/nginx/dynmaps.conf
124122
sed -i 's/,\[::\]//g' data/conf/dovecot/dovecot.conf
125123
sed -i 's/\[::\]://g' data/conf/phpfpm/php-fpm.d/pools.conf
126124
```
127125

126+
**6.** Disable IPv6 listeners for NGINX
127+
128+
Set `DISABLE_IPv6=y` in `mailcow.conf`
129+
130+
For this change to be effective, you need to recreate the `nginx-mailcow` Container
131+
132+
=== "docker compose (Plugin)"
133+
134+
``` bash
135+
docker compose up -d
136+
```
137+
138+
=== "docker-compose (Standalone)"
139+
140+
``` bash
141+
docker-compose up -d
142+
```
143+

0 commit comments

Comments
 (0)