From d9af48d291d1008174b7f2d6792b78a601fa5240 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Yannik=20J=C3=A9r=C3=B4me=20B=C3=BCchi?= Date: Tue, 28 Jun 2022 12:53:01 +0200 Subject: [PATCH 01/10] Update third_party-roundcube.en.md update Roundcube from 1.5.2 to 1.5.3 update RCMCardDAV from 4.3.0 to 4.4.1 --- docs/third_party/third_party-roundcube.en.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/third_party/third_party-roundcube.en.md b/docs/third_party/third_party-roundcube.en.md index 9e3e93fb0..f20f7f2aa 100644 --- a/docs/third_party/third_party-roundcube.en.md +++ b/docs/third_party/third_party-roundcube.en.md @@ -4,10 +4,10 @@ Download Roundcube 1.5.x to the web htdocs directory and extract it (here `rc/`) ``` # Check for a newer release! cd data/web -wget -O - https://github.com/roundcube/roundcubemail/releases/download/1.5.2/roundcubemail-1.5.2-complete.tar.gz | tar xfvz - +wget -O - https://github.com/roundcube/roundcubemail/releases/download/1.5.3/roundcubemail-1.5.3-complete.tar.gz | tar xfvz - # Change folder name -mv roundcubemail-1.5.2 rc +mv roundcubemail-1.5.3 rc # Change permissions chown -R root: rc/ @@ -120,7 +120,7 @@ $config['password_query'] = "UPDATE mailbox SET password = %P WHERE username = % Download the latest release of [RCMCardDAV](https://github.com/mstilkerich/rcmcarddav) to the Roundcube plugin directory and extract it (here `rc/plugins`): ``` cd data/web/rc/plugins -wget -O - https://github.com/mstilkerich/rcmcarddav/releases/download/v4.3.0/carddav-v4.3.0.tar.gz | tar xfvz - +wget -O - https://github.com/mstilkerich/rcmcarddav/releases/download/v4.4.1/carddav-v4.4.1.tar.gz | tar xfvz - chown -R root: carddav/ ``` @@ -180,8 +180,8 @@ docker exec -it mailcowdockerized_php-fpm-mailcow_1 bash # Install required upgrade dependency, then upgrade Roundcube to wanted release apk add rsync cd /tmp -wget -O - https://github.com/roundcube/roundcubemail/releases/download/1.5.2/roundcubemail-1.5.2-complete.tar.gz | tar xfvz - -cd roundcubemail-1.5.2 +wget -O - https://github.com/roundcube/roundcubemail/releases/download/1.5.3/roundcubemail-1.5.3-complete.tar.gz | tar xfvz - +cd roundcubemail-1.5.3 bin/installto.sh /web/rc # Type 'Y' and press enter to upgrade your install of Roundcube @@ -248,4 +248,4 @@ Finally, restart mailcow ``` docker-compose down docker-compose up -d -``` \ No newline at end of file +``` From c5dad998b46f8600d5f679ae33c4e2044cf9a633 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Yannik=20J=C3=A9r=C3=B4me=20B=C3=BCchi?= Date: Tue, 28 Jun 2022 12:55:30 +0200 Subject: [PATCH 02/10] Update third_party-roundcube.de.md update Roundcube from 1.5.2 to 1.5.3 update RCMCardDAV from 4.3.0 to 4.4.1 --- docs/third_party/third_party-roundcube.de.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/third_party/third_party-roundcube.de.md b/docs/third_party/third_party-roundcube.de.md index 6e912fb4e..e4641bd49 100644 --- a/docs/third_party/third_party-roundcube.de.md +++ b/docs/third_party/third_party-roundcube.de.md @@ -4,10 +4,10 @@ Laden Sie Roundcube 1.5.x in das Web htdocs Verzeichnis herunter und entpacken S ``` # Prüfen Sie, ob eine neuere Version vorliegt! cd daten/web -wget -O - https://github.com/roundcube/roundcubemail/releases/download/1.5.2/roundcubemail-1.5.2-complete.tar.gz | tar xfvz - +wget -O - https://github.com/roundcube/roundcubemail/releases/download/1.5.3/roundcubemail-1.5.3-complete.tar.gz | tar xfvz - # Ändern Sie den Ordnernamen -mv roundcubemail-1.5.2 rc +mv roundcubemail-1.5.3 rc # Berechtigungen ändern chown -R root: rc/ @@ -120,7 +120,7 @@ $config['password_query'] = "UPDATE mailbox SET password = %P WHERE username = % Laden Sie die neueste Version von [RCMCardDAV](https://github.com/mstilkerich/rcmcarddav) in das Roundcube Plugin Verzeichnis und entpacken Sie es (hier `rc/plugins`): ``` cd data/web/rc/plugins -wget -O - https://github.com/mstilkerich/rcmcarddav/releases/download/v4.3.0/carddav-v4.3.0.tar.gz | tar xfvz - +wget -O - https://github.com/mstilkerich/rcmcarddav/releases/download/v4.4.1/carddav-v4.4.1-roundcube16.tar.gz | tar xfvz - chown -R root: carddav/ ``` @@ -180,8 +180,8 @@ docker exec -it mailcowdockerized_php-fpm-mailcow_1 bash # Installieren Sie die erforderliche Upgrade-Abhängigkeit, dann aktualisieren Sie Roundcube auf die gewünschte Version apk add rsync cd /tmp -wget -O - https://github.com/roundcube/roundcubemail/releases/download/1.5.2/roundcubemail-1.5.2-complete.tar.gz | tar xfvz - -cd roundcubemail-1.5.2 +wget -O - https://github.com/roundcube/roundcubemail/releases/download/1.5.3/roundcubemail-1.5.3-complete.tar.gz | tar xfvz - +cd roundcubemail-1.5.3 bin/installto.sh /web/rc # Geben Sie 'Y' ein und drücken Sie die Eingabetaste, um Ihre Installation von Roundcube zu aktualisieren. From 0f26c418c554a0d20e8a7bec697e24793a3a780c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Yannik=20J=C3=A9r=C3=B4me=20B=C3=BCchi?= Date: Tue, 28 Jun 2022 12:57:12 +0200 Subject: [PATCH 03/10] Update third_party-roundcube.en.md --- docs/third_party/third_party-roundcube.en.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/third_party/third_party-roundcube.en.md b/docs/third_party/third_party-roundcube.en.md index f20f7f2aa..5a133b136 100644 --- a/docs/third_party/third_party-roundcube.en.md +++ b/docs/third_party/third_party-roundcube.en.md @@ -120,7 +120,7 @@ $config['password_query'] = "UPDATE mailbox SET password = %P WHERE username = % Download the latest release of [RCMCardDAV](https://github.com/mstilkerich/rcmcarddav) to the Roundcube plugin directory and extract it (here `rc/plugins`): ``` cd data/web/rc/plugins -wget -O - https://github.com/mstilkerich/rcmcarddav/releases/download/v4.4.1/carddav-v4.4.1.tar.gz | tar xfvz - +wget -O - https://github.com/mstilkerich/rcmcarddav/releases/download/v4.4.1/carddav-v4.4.1-roundcube16.tar.gz | tar xfvz - chown -R root: carddav/ ``` From 0ccc43a362c15a4ae113ad002905d494fb82c749 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Yannik=20J=C3=A9r=C3=B4me=20B=C3=BCchi?= Date: Wed, 29 Jun 2022 22:01:30 +0200 Subject: [PATCH 04/10] Update third_party-roundcube.de.md update to docker compose v2 --- docs/third_party/third_party-roundcube.de.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/third_party/third_party-roundcube.de.md b/docs/third_party/third_party-roundcube.de.md index e4641bd49..e3c34f9ed 100644 --- a/docs/third_party/third_party-roundcube.de.md +++ b/docs/third_party/third_party-roundcube.de.md @@ -175,7 +175,7 @@ Ein Upgrade von Roundcube ist recht einfach: Gehen Sie auf die [Github releases] ``` # Starten Sie eine Bash-Sitzung des mailcow PHP-Containers -docker exec -it mailcowdockerized_php-fpm-mailcow_1 bash +docker exec -it mailcowdockerized-php-fpm-mailcow-1 bash # Installieren Sie die erforderliche Upgrade-Abhängigkeit, dann aktualisieren Sie Roundcube auf die gewünschte Version apk add rsync @@ -246,8 +246,8 @@ Kopieren Sie den Inhalt der folgenden Dateien aus diesem [Snippet](https://gitla Starten Sie schließlich mailcow neu ``` -docker-compose down -docker-compose up -d +docker compose down +docker compose up -d ``` From 982c56bd8b215fc847c1476feda7aefddee5950e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Yannik=20J=C3=A9r=C3=B4me=20B=C3=BCchi?= Date: Wed, 29 Jun 2022 22:02:35 +0200 Subject: [PATCH 05/10] Update third_party-roundcube.en.md update to docker compose v2 --- docs/third_party/third_party-roundcube.en.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/third_party/third_party-roundcube.en.md b/docs/third_party/third_party-roundcube.en.md index 5a133b136..c4c9f4db9 100644 --- a/docs/third_party/third_party-roundcube.en.md +++ b/docs/third_party/third_party-roundcube.en.md @@ -175,7 +175,7 @@ Upgrading Roundcube is rather simple, go to the [Github releases](https://github ``` # Enter a bash session of the mailcow PHP container -docker exec -it mailcowdockerized_php-fpm-mailcow_1 bash +docker exec -it mailcowdockerized-php-fpm-mailcow-1 bash # Install required upgrade dependency, then upgrade Roundcube to wanted release apk add rsync @@ -246,6 +246,6 @@ Copy the contents of the following files from this [Snippet](https://gitlab.com/ Finally, restart mailcow ``` -docker-compose down -docker-compose up -d +docker compose down +docker compose up -d ``` From 3878e797f961c70b062e2f0b6aa70278bd62985d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Yannik=20J=C3=A9r=C3=B4me=20B=C3=BCchi?= Date: Wed, 29 Jun 2022 22:04:40 +0200 Subject: [PATCH 06/10] Update third_party-nextcloud.en.md update to docker compose v2 --- docs/third_party/third_party-nextcloud.en.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/third_party/third_party-nextcloud.en.md b/docs/third_party/third_party-nextcloud.en.md index 697637b26..0db4fa9db 100644 --- a/docs/third_party/third_party-nextcloud.en.md +++ b/docs/third_party/third_party-nextcloud.en.md @@ -6,7 +6,7 @@ Nextcloud can be set up (parameter `-i`) and removed (parameter `-p`) with the [ In case you have forgotten the password (e.g. for admin) and can't request a new one [via the password reset link on the login screen](https://docs.nextcloud.com/server/20/admin_manual/configuration_user/reset_admin_password.html?highlight=reset) calling the helper script with `-r` as parameter allows you to set a new password. Only use this option if your Nextcloud isn't configured to use mailcow for authentication as described in the next section. -In order for mailcow to generate a a certificate for the nextcloud domain you need to add "nextcloud.domain.tld" to ADDITIONAL_SAN in mailcow.conf and run `docker-compose up -d` to apply. For more informaton refer to: [Advanced SSL](../post_installation/firststeps-ssl.md). +In order for mailcow to generate a a certificate for the nextcloud domain you need to add "nextcloud.domain.tld" to ADDITIONAL_SAN in mailcow.conf and run `docker compose up -d` to apply. For more informaton refer to: [Advanced SSL](../post_installation/firststeps-ssl.md). ## Background jobs @@ -22,9 +22,9 @@ services: ofelia.job-exec.nextcloud-cron.command: "su www-data -s /bin/bash -c \"/usr/local/bin/php -f /web/nextcloud/cron.php\"" ``` -After adding these lines the `docker-compose up -d` command must be executed to update the docker image and also the docker scheduler image must be restarted to - pick up the new job definition by executing `docker-compose restart ofelia-mailcow`. To check if the job was successfully picked up by `ofelia` the command - `docker-compose logs ofelia-mailcow` will contain a line similar to `New job registered "nextcloud-cron" - ...`. +After adding these lines the `docker compose up -d` command must be executed to update the docker image and also the docker scheduler image must be restarted to + pick up the new job definition by executing `docker compose restart ofelia-mailcow`. To check if the job was successfully picked up by `ofelia` the command + `docker compose logs ofelia-mailcow` will contain a line similar to `New job registered "nextcloud-cron" - ...`. By adding these lines the background jobs will be executed every 5 minutes. To verify that the execution works correctly, the only way is to see it in the basic settings when logged in as an admin in Nextcloud. If everything is correct the first scheduled execution will change the background jobs processing setting to @@ -84,7 +84,7 @@ Click the _Save_ button at the very bottom of the page. If you have previously used Nextcloud with mailcow authentication via user\_external/IMAP, you need to perform some additional steps to link your existing user accounts with OAuth2. 1\. Click the button in the top right corner and select _Apps_. Scroll down to the _External user authentication_ app and click _Remove_ next to it. -2\. Run the following queries in your Nextcloud database (if you set up Nextcloud using mailcow's script, you can run `source mailcow.conf && docker-compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME`): +2\. Run the following queries in your Nextcloud database (if you set up Nextcloud using mailcow's script, you can run `source mailcow.conf && docker compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME`): ``` INSERT INTO nc_users (uid, uid_lower) SELECT DISTINCT uid, LOWER(uid) FROM nc_users_external; INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT("Mailcow-", uid) FROM nc_users_external; @@ -94,7 +94,7 @@ INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT If you have previously used Nextcloud without mailcow authentication, but with the same usernames as mailcow, you can also link your existing user accounts with OAuth2. -1\. Run the following queries in your Nextcloud database (if you set up Nextcloud using mailcow's script, you can run `source mailcow.conf && docker-compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME`): +1\. Run the following queries in your Nextcloud database (if you set up Nextcloud using mailcow's script, you can run `source mailcow.conf && docker compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME`): ``` INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT("Mailcow-", uid) FROM nc_users; ``` @@ -125,4 +125,4 @@ It may happen that you cannot reach the Nextcloud instance from your network. Th ``` After the changes have been made, the nginx container must be restarted. -`docker-compose restart nginx-mailcow` \ No newline at end of file +`docker compose restart nginx-mailcow` From 9ca8d06c40e04dfa9dd87769b9fb8ad1174f5d90 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Yannik=20J=C3=A9r=C3=B4me=20B=C3=BCchi?= Date: Wed, 29 Jun 2022 22:05:25 +0200 Subject: [PATCH 07/10] Update third_party-nextcloud.de.md update to docker compose v2 --- docs/third_party/third_party-nextcloud.de.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/third_party/third_party-nextcloud.de.md b/docs/third_party/third_party-nextcloud.de.md index bd1482d1f..fc07aaba8 100644 --- a/docs/third_party/third_party-nextcloud.de.md +++ b/docs/third_party/third_party-nextcloud.de.md @@ -6,7 +6,7 @@ Nextcloud kann mit dem [helper script](https://github.com/mailcow/mailcow-docker Für den Fall, dass Sie das Passwort (z.B. für admin) vergessen haben und kein neues anfordern können [über den Passwort-Reset-Link auf dem Login-Bildschirm] (https://docs.nextcloud.com/server/20/admin_manual/configuration_user/reset_admin_password.html?highlight=reset), können Sie durch den Aufruf des Helper-Skripts mit `-r` als Parameter ein neues Passwort setzen. Verwenden Sie diese Option nur, wenn Ihre Nextcloud nicht so konfiguriert ist, dass Sie mailcow zur Authentifizierung verwendet, wie im nächsten Abschnitt beschrieben. -Damit mailcow ein Zertifikat für die Nextcloud Domain generieren kann, muss die Domain unter welcher die Nextcloud später erreichbar sein soll als ADDITIONAL_SAN in die mailcow.conf hinzufügt werden und `docker-compose up -d` zur Übernahme ausgeführt werden. Für weitere Informationen siehe: [Erweitertes SSL](../post_installation/firststeps-ssl.md). +Damit mailcow ein Zertifikat für die Nextcloud Domain generieren kann, muss die Domain unter welcher die Nextcloud später erreichbar sein soll als ADDITIONAL_SAN in die mailcow.conf hinzufügt werden und `docker compose up -d` zur Übernahme ausgeführt werden. Für weitere Informationen siehe: [Erweitertes SSL](../post_installation/firststeps-ssl.md). ## Hintergrund-Aufgaben @@ -23,9 +23,9 @@ services: ofelia.job-exec.nextcloud-cron.command: "su www-data -s /bin/bash -c \"/usr/local/bin/php -f /web/nextcloud/cron.php\"" ``` -Nachdem diese Zeilen hinzugefügt wurden muss `docker-compose up -d` ausgeführt werden, um das Docker Image mit den entsprechenden Labels zu versehen. Danach muss - zudem der docker scheduler neu gestartet werden, um den neuen Job zu registrieren. Dazu wird `docker-compose restart ofelia-mailcow` ausgeführt. Zur - Überprüfung, ob die `ofelia` Konfiguration korrekt ist geladen wurde, kann mittels `docker-compose logs ofelia-mailcow` nach einer Zeile mit dem Inhalt +Nachdem diese Zeilen hinzugefügt wurden muss `docker compose up -d` ausgeführt werden, um das Docker Image mit den entsprechenden Labels zu versehen. Danach muss + zudem der docker scheduler neu gestartet werden, um den neuen Job zu registrieren. Dazu wird `docker compose restart ofelia-mailcow` ausgeführt. Zur + Überprüfung, ob die `ofelia` Konfiguration korrekt ist geladen wurde, kann mittels `docker compose logs ofelia-mailcow` nach einer Zeile mit dem Inhalt `New job registered "nextcloud-cron" - ...` gesucht werden. Hierdurch wird alle 5 Minuten die Hintergrundverarbeitung gestartet. Da die Ausführung selbst keine Ausgabe liefert, kann die korrekte Funktionsweise in den @@ -86,7 +86,7 @@ Klicken Sie auf die Schaltfläche _Speichern_ ganz unten auf der Seite. Wenn Sie bisher Nextcloud mit mailcow-Authentifizierung über user\_external/IMAP verwendet haben, müssen Sie einige zusätzliche Schritte durchführen, um Ihre bestehenden Benutzerkonten mit OAuth2 zu verknüpfen. 1\. Klicken Sie auf die Schaltfläche in der oberen rechten Ecke und wählen Sie _Apps_. Scrollen Sie nach unten zur App _Externe Benutzerauthentifizierung_ und klicken Sie daneben auf _Entfernen_. -2\. Führen Sie die folgenden Abfragen in Ihrer Nextcloud-Datenbank aus (wenn Sie Nextcloud mit dem Skript von mailcow einrichten, können Sie `source mailcow.conf && docker-compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME` ausführen): +2\. Führen Sie die folgenden Abfragen in Ihrer Nextcloud-Datenbank aus (wenn Sie Nextcloud mit dem Skript von mailcow einrichten, können Sie `source mailcow.conf && docker compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME` ausführen): ``` INSERT INTO nc_users (uid, uid_lower) SELECT DISTINCT uid, LOWER(uid) FROM nc_users_external; INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT("Mailcow-", uid) FROM nc_users_external; @@ -96,7 +96,7 @@ INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT Wenn Sie Nextcloud bisher ohne mailcow-Authentifizierung, aber mit den gleichen Benutzernamen wie mailcow genutzt haben, können Sie Ihre bestehenden Benutzerkonten auch mit OAuth2 verknüpfen. -1\. Führen Sie die folgenden Abfragen in Ihrer Nextcloud-Datenbank aus (wenn Sie Nextcloud mit dem Skript von mailcow einrichten, können Sie `source mailcow.conf && docker-compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME` ausführen): +1\. Führen Sie die folgenden Abfragen in Ihrer Nextcloud-Datenbank aus (wenn Sie Nextcloud mit dem Skript von mailcow einrichten, können Sie `source mailcow.conf && docker compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME` ausführen): ``` INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT("Mailcow-", uid) FROM nc_users; ``` @@ -127,4 +127,4 @@ Es kann vorkommen, dass Sie die Nextcloud-Instanz von Ihrem Netzwerk aus nicht e ``` Nachdem die Änderungen vorgenommen wurden, muss der nginx-Container neu gestartet werden. -`docker-compose restart nginx-mailcow` \ No newline at end of file +`docker compose restart nginx-mailcow` From d141016dfc021231c66219782ef34b33d566e687 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Yannik=20J=C3=A9r=C3=B4me=20B=C3=BCchi?= Date: Thu, 30 Jun 2022 20:57:51 +0200 Subject: [PATCH 08/10] Update third_party-nextcloud.de.md --- docs/third_party/third_party-nextcloud.de.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/third_party/third_party-nextcloud.de.md b/docs/third_party/third_party-nextcloud.de.md index fc07aaba8..586cd113f 100644 --- a/docs/third_party/third_party-nextcloud.de.md +++ b/docs/third_party/third_party-nextcloud.de.md @@ -6,7 +6,7 @@ Nextcloud kann mit dem [helper script](https://github.com/mailcow/mailcow-docker Für den Fall, dass Sie das Passwort (z.B. für admin) vergessen haben und kein neues anfordern können [über den Passwort-Reset-Link auf dem Login-Bildschirm] (https://docs.nextcloud.com/server/20/admin_manual/configuration_user/reset_admin_password.html?highlight=reset), können Sie durch den Aufruf des Helper-Skripts mit `-r` als Parameter ein neues Passwort setzen. Verwenden Sie diese Option nur, wenn Ihre Nextcloud nicht so konfiguriert ist, dass Sie mailcow zur Authentifizierung verwendet, wie im nächsten Abschnitt beschrieben. -Damit mailcow ein Zertifikat für die Nextcloud Domain generieren kann, muss die Domain unter welcher die Nextcloud später erreichbar sein soll als ADDITIONAL_SAN in die mailcow.conf hinzufügt werden und `docker compose up -d` zur Übernahme ausgeführt werden. Für weitere Informationen siehe: [Erweitertes SSL](../post_installation/firststeps-ssl.md). +Damit mailcow ein Zertifikat für die Nextcloud Domain generieren kann, muss die Domain unter welcher die Nextcloud später erreichbar sein soll als ADDITIONAL_SAN in die mailcow.conf hinzufügt werden und `docker-compose up -d` zur Übernahme ausgeführt werden. Für weitere Informationen siehe: [Erweitertes SSL](../post_installation/firststeps-ssl.md). ## Hintergrund-Aufgaben From 676731902f19b37696294828a7aff3d5615e8d6e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Yannik=20J=C3=A9r=C3=B4me=20B=C3=BCchi?= Date: Thu, 30 Jun 2022 20:58:38 +0200 Subject: [PATCH 09/10] Update third_party-nextcloud.en.md --- docs/third_party/third_party-nextcloud.en.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/third_party/third_party-nextcloud.en.md b/docs/third_party/third_party-nextcloud.en.md index 0db4fa9db..2389d9f54 100644 --- a/docs/third_party/third_party-nextcloud.en.md +++ b/docs/third_party/third_party-nextcloud.en.md @@ -6,7 +6,7 @@ Nextcloud can be set up (parameter `-i`) and removed (parameter `-p`) with the [ In case you have forgotten the password (e.g. for admin) and can't request a new one [via the password reset link on the login screen](https://docs.nextcloud.com/server/20/admin_manual/configuration_user/reset_admin_password.html?highlight=reset) calling the helper script with `-r` as parameter allows you to set a new password. Only use this option if your Nextcloud isn't configured to use mailcow for authentication as described in the next section. -In order for mailcow to generate a a certificate for the nextcloud domain you need to add "nextcloud.domain.tld" to ADDITIONAL_SAN in mailcow.conf and run `docker compose up -d` to apply. For more informaton refer to: [Advanced SSL](../post_installation/firststeps-ssl.md). +In order for mailcow to generate a a certificate for the nextcloud domain you need to add "nextcloud.domain.tld" to ADDITIONAL_SAN in mailcow.conf and run `docker-compose up -d` to apply. For more informaton refer to: [Advanced SSL](../post_installation/firststeps-ssl.md). ## Background jobs From 9608a8d1d4caf5a44e0f286f3e70bec944eb230a Mon Sep 17 00:00:00 2001 From: Niklas Meyer Date: Fri, 1 Jul 2022 10:56:27 +0200 Subject: [PATCH 10/10] Corrected Compose - --- docs/third_party/third_party-nextcloud.de.md | 12 ++++++------ docs/third_party/third_party-nextcloud.en.md | 12 ++++++------ docs/third_party/third_party-roundcube.de.md | 4 ++-- docs/third_party/third_party-roundcube.en.md | 6 +++--- 4 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/third_party/third_party-nextcloud.de.md b/docs/third_party/third_party-nextcloud.de.md index 586cd113f..bd1482d1f 100644 --- a/docs/third_party/third_party-nextcloud.de.md +++ b/docs/third_party/third_party-nextcloud.de.md @@ -23,9 +23,9 @@ services: ofelia.job-exec.nextcloud-cron.command: "su www-data -s /bin/bash -c \"/usr/local/bin/php -f /web/nextcloud/cron.php\"" ``` -Nachdem diese Zeilen hinzugefügt wurden muss `docker compose up -d` ausgeführt werden, um das Docker Image mit den entsprechenden Labels zu versehen. Danach muss - zudem der docker scheduler neu gestartet werden, um den neuen Job zu registrieren. Dazu wird `docker compose restart ofelia-mailcow` ausgeführt. Zur - Überprüfung, ob die `ofelia` Konfiguration korrekt ist geladen wurde, kann mittels `docker compose logs ofelia-mailcow` nach einer Zeile mit dem Inhalt +Nachdem diese Zeilen hinzugefügt wurden muss `docker-compose up -d` ausgeführt werden, um das Docker Image mit den entsprechenden Labels zu versehen. Danach muss + zudem der docker scheduler neu gestartet werden, um den neuen Job zu registrieren. Dazu wird `docker-compose restart ofelia-mailcow` ausgeführt. Zur + Überprüfung, ob die `ofelia` Konfiguration korrekt ist geladen wurde, kann mittels `docker-compose logs ofelia-mailcow` nach einer Zeile mit dem Inhalt `New job registered "nextcloud-cron" - ...` gesucht werden. Hierdurch wird alle 5 Minuten die Hintergrundverarbeitung gestartet. Da die Ausführung selbst keine Ausgabe liefert, kann die korrekte Funktionsweise in den @@ -86,7 +86,7 @@ Klicken Sie auf die Schaltfläche _Speichern_ ganz unten auf der Seite. Wenn Sie bisher Nextcloud mit mailcow-Authentifizierung über user\_external/IMAP verwendet haben, müssen Sie einige zusätzliche Schritte durchführen, um Ihre bestehenden Benutzerkonten mit OAuth2 zu verknüpfen. 1\. Klicken Sie auf die Schaltfläche in der oberen rechten Ecke und wählen Sie _Apps_. Scrollen Sie nach unten zur App _Externe Benutzerauthentifizierung_ und klicken Sie daneben auf _Entfernen_. -2\. Führen Sie die folgenden Abfragen in Ihrer Nextcloud-Datenbank aus (wenn Sie Nextcloud mit dem Skript von mailcow einrichten, können Sie `source mailcow.conf && docker compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME` ausführen): +2\. Führen Sie die folgenden Abfragen in Ihrer Nextcloud-Datenbank aus (wenn Sie Nextcloud mit dem Skript von mailcow einrichten, können Sie `source mailcow.conf && docker-compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME` ausführen): ``` INSERT INTO nc_users (uid, uid_lower) SELECT DISTINCT uid, LOWER(uid) FROM nc_users_external; INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT("Mailcow-", uid) FROM nc_users_external; @@ -96,7 +96,7 @@ INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT Wenn Sie Nextcloud bisher ohne mailcow-Authentifizierung, aber mit den gleichen Benutzernamen wie mailcow genutzt haben, können Sie Ihre bestehenden Benutzerkonten auch mit OAuth2 verknüpfen. -1\. Führen Sie die folgenden Abfragen in Ihrer Nextcloud-Datenbank aus (wenn Sie Nextcloud mit dem Skript von mailcow einrichten, können Sie `source mailcow.conf && docker compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME` ausführen): +1\. Führen Sie die folgenden Abfragen in Ihrer Nextcloud-Datenbank aus (wenn Sie Nextcloud mit dem Skript von mailcow einrichten, können Sie `source mailcow.conf && docker-compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME` ausführen): ``` INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT("Mailcow-", uid) FROM nc_users; ``` @@ -127,4 +127,4 @@ Es kann vorkommen, dass Sie die Nextcloud-Instanz von Ihrem Netzwerk aus nicht e ``` Nachdem die Änderungen vorgenommen wurden, muss der nginx-Container neu gestartet werden. -`docker compose restart nginx-mailcow` +`docker-compose restart nginx-mailcow` \ No newline at end of file diff --git a/docs/third_party/third_party-nextcloud.en.md b/docs/third_party/third_party-nextcloud.en.md index 2389d9f54..697637b26 100644 --- a/docs/third_party/third_party-nextcloud.en.md +++ b/docs/third_party/third_party-nextcloud.en.md @@ -22,9 +22,9 @@ services: ofelia.job-exec.nextcloud-cron.command: "su www-data -s /bin/bash -c \"/usr/local/bin/php -f /web/nextcloud/cron.php\"" ``` -After adding these lines the `docker compose up -d` command must be executed to update the docker image and also the docker scheduler image must be restarted to - pick up the new job definition by executing `docker compose restart ofelia-mailcow`. To check if the job was successfully picked up by `ofelia` the command - `docker compose logs ofelia-mailcow` will contain a line similar to `New job registered "nextcloud-cron" - ...`. +After adding these lines the `docker-compose up -d` command must be executed to update the docker image and also the docker scheduler image must be restarted to + pick up the new job definition by executing `docker-compose restart ofelia-mailcow`. To check if the job was successfully picked up by `ofelia` the command + `docker-compose logs ofelia-mailcow` will contain a line similar to `New job registered "nextcloud-cron" - ...`. By adding these lines the background jobs will be executed every 5 minutes. To verify that the execution works correctly, the only way is to see it in the basic settings when logged in as an admin in Nextcloud. If everything is correct the first scheduled execution will change the background jobs processing setting to @@ -84,7 +84,7 @@ Click the _Save_ button at the very bottom of the page. If you have previously used Nextcloud with mailcow authentication via user\_external/IMAP, you need to perform some additional steps to link your existing user accounts with OAuth2. 1\. Click the button in the top right corner and select _Apps_. Scroll down to the _External user authentication_ app and click _Remove_ next to it. -2\. Run the following queries in your Nextcloud database (if you set up Nextcloud using mailcow's script, you can run `source mailcow.conf && docker compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME`): +2\. Run the following queries in your Nextcloud database (if you set up Nextcloud using mailcow's script, you can run `source mailcow.conf && docker-compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME`): ``` INSERT INTO nc_users (uid, uid_lower) SELECT DISTINCT uid, LOWER(uid) FROM nc_users_external; INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT("Mailcow-", uid) FROM nc_users_external; @@ -94,7 +94,7 @@ INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT If you have previously used Nextcloud without mailcow authentication, but with the same usernames as mailcow, you can also link your existing user accounts with OAuth2. -1\. Run the following queries in your Nextcloud database (if you set up Nextcloud using mailcow's script, you can run `source mailcow.conf && docker compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME`): +1\. Run the following queries in your Nextcloud database (if you set up Nextcloud using mailcow's script, you can run `source mailcow.conf && docker-compose exec mysql-mailcow mysql -u$DBUSER -p$DBPASS $DBNAME`): ``` INSERT INTO nc_sociallogin_connect (uid, identifier) SELECT DISTINCT uid, CONCAT("Mailcow-", uid) FROM nc_users; ``` @@ -125,4 +125,4 @@ It may happen that you cannot reach the Nextcloud instance from your network. Th ``` After the changes have been made, the nginx container must be restarted. -`docker compose restart nginx-mailcow` +`docker-compose restart nginx-mailcow` \ No newline at end of file diff --git a/docs/third_party/third_party-roundcube.de.md b/docs/third_party/third_party-roundcube.de.md index e3c34f9ed..093901a3c 100644 --- a/docs/third_party/third_party-roundcube.de.md +++ b/docs/third_party/third_party-roundcube.de.md @@ -246,8 +246,8 @@ Kopieren Sie den Inhalt der folgenden Dateien aus diesem [Snippet](https://gitla Starten Sie schließlich mailcow neu ``` -docker compose down -docker compose up -d +docker-compose down +docker-compose up -d ``` diff --git a/docs/third_party/third_party-roundcube.en.md b/docs/third_party/third_party-roundcube.en.md index c4c9f4db9..a9d85a59d 100644 --- a/docs/third_party/third_party-roundcube.en.md +++ b/docs/third_party/third_party-roundcube.en.md @@ -246,6 +246,6 @@ Copy the contents of the following files from this [Snippet](https://gitlab.com/ Finally, restart mailcow ``` -docker compose down -docker compose up -d -``` +docker-compose down +docker-compose up -d +``` \ No newline at end of file