elmau
/
iredmail-doc
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update en_US/upgrade/0-upgrade.iredmail.0.9.2-0.9.3.md: redirects url of /.well-known/carddav request to SOGo.

This commit is contained in:
Zhang Huangbin 2015-12-05 13:19:44 +08:00
parent dbc8e08b74
commit 0b1469c15d
2 changed files with 81 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
en_US/upgrade/0-upgrade.iredmail.0.9.2-0.9.3.md
View File

@ -328,12 +328,18 @@ add_header Strict-Transport-Security "max-age=15768000; includeSubdomains";
### SOGo: Fix improper settings in Apache/Nginx config file ### SOGo: Fix improper settings in Apache/Nginx config file
iRedMail-0.9.2 has improper settings in Apache/Nginx config files, when you iRedMail-0.9.2 has improper settings in Apache/Nginx config files:
try to view attachment in email, it will redirect the URL to
`https://127.0.0.1/...`. * when you try to view attachment in email, it will redirect the URL to
`https://127.0.0.1/...`.
* iOS mobile devices will try to access web url
`https://.../.well-known/carddav`, but it's not defined in Apache/Nginx
config files.
<h4>Apache</h4> <h4>Apache</h4>
<h5>1: Comment out incorrect settings</h5>
For Apache: Please make sure below settings are commented out in Apache For Apache: Please make sure below settings are commented out in Apache
config file, then restart Apache service. config file, then restart Apache service.
@ -348,8 +354,27 @@ config file, then restart Apache service.
#RequestHeader set "x-webobjects-server-url" "https://yourhostname" #RequestHeader set "x-webobjects-server-url" "https://yourhostname"
``` ```
<h5>2: Redirect `/.well-known/carddav` access to SOGo</h5>
Find below line in `SOGo.conf`:
```
RewriteRule ^/.well-known/caldav/?$ /SOGo/dav [R=301]
```
Add a new line right after above line:
```
RewriteRule ^/.well-known/caldav/?$ /SOGo/dav [R=301]
RewriteRule ^/.well-known/carddav/?$ /SOGo/dav [R=301]
```
Restarting Apache service is required.
<h4>Nginx</h4> <h4>Nginx</h4>
<h5>1: Comment out incorrect settings</h5>
For Nginx: Please make sure below settings are commented out in Nginx config For Nginx: Please make sure below settings are commented out in Nginx config
file, then restart or reload Nginx service. file, then restart or reload Nginx service.
@ -362,6 +387,23 @@ file, then restart or reload Nginx service.
#proxy_set_header x-webobjects-server-url $scheme://$host; #proxy_set_header x-webobjects-server-url $scheme://$host;
``` ```
<h5>2: Redirect `/.well-known/carddav` access to SOGo</h5>
Find below line in `default.conf`:
```
rewrite ^/.well-known/caldav /SOGo/dav permanent;
```
Add a new line right after above line:
```
rewrite ^/.well-known/caldav /SOGo/dav permanent;
rewrite ^/.well-known/carddav /SOGo/dav permanent;
```
Restarting Nginx service is required.
### SOGo: The Dovecot Master User used by SOGo doesn't work due to incorrect username. ### SOGo: The Dovecot Master User used by SOGo doesn't work due to incorrect username.
Note: you can skip this step if you don't run SOGo groupware, and iRedMail Note: you can skip this step if you don't run SOGo groupware, and iRedMail

39
html/upgrade.iredmail.0.9.2-0.9.3.html
View File

@ -355,11 +355,18 @@ add_header Strict-Transport-Security &quot;max-age=15768000; includeSubdomains&q
</code></pre> </code></pre>
<h3 id="sogo-fix-improper-settings-in-apachenginx-config-file">SOGo: Fix improper settings in Apache/Nginx config file</h3> <h3 id="sogo-fix-improper-settings-in-apachenginx-config-file">SOGo: Fix improper settings in Apache/Nginx config file</h3>
<p>iRedMail-0.9.2 has improper settings in Apache/Nginx config files, when you <p>iRedMail-0.9.2 has improper settings in Apache/Nginx config files:</p>
try to view attachment in email, it will redirect the URL to <ul>
<code>https://127.0.0.1/...</code>.</p> <li>when you try to view attachment in email, it will redirect the URL to
<code>https://127.0.0.1/...</code>.</li>
<li>iOS mobile devices will try to access web url
<code>https://.../.well-known/carddav</code>, but it's not defined in Apache/Nginx
config files.</li>
</ul>
<h4>Apache</h4> <h4>Apache</h4>
<h5>1: Comment out incorrect settings</h5>
<p>For Apache: Please make sure below settings are commented out in Apache <p>For Apache: Please make sure below settings are commented out in Apache
config file, then restart Apache service.</p> config file, then restart Apache service.</p>
<ul> <ul>
@ -373,8 +380,22 @@ config file, then restart Apache service.</p>
#RequestHeader set &quot;x-webobjects-server-url&quot; &quot;https://yourhostname&quot; #RequestHeader set &quot;x-webobjects-server-url&quot; &quot;https://yourhostname&quot;
</code></pre> </code></pre>
<h5>2: Redirect `/.well-known/carddav` access to SOGo</h5>
<p>Find below line in <code>SOGo.conf</code>:</p>
<pre><code> RewriteRule ^/.well-known/caldav/?$ /SOGo/dav [R=301]
</code></pre>
<p>Add a new line right after above line:</p>
<pre><code> RewriteRule ^/.well-known/caldav/?$ /SOGo/dav [R=301]
RewriteRule ^/.well-known/carddav/?$ /SOGo/dav [R=301]
</code></pre>
<p>Restarting Apache service is required.</p>
<h4>Nginx</h4> <h4>Nginx</h4>
<h5>1: Comment out incorrect settings</h5>
<p>For Nginx: Please make sure below settings are commented out in Nginx config <p>For Nginx: Please make sure below settings are commented out in Nginx config
file, then restart or reload Nginx service.</p> file, then restart or reload Nginx service.</p>
<ul> <ul>
@ -386,6 +407,18 @@ file, then restart or reload Nginx service.</p>
#proxy_set_header x-webobjects-server-url $scheme://$host; #proxy_set_header x-webobjects-server-url $scheme://$host;
</code></pre> </code></pre>
<h5>2: Redirect `/.well-known/carddav` access to SOGo</h5>
<p>Find below line in <code>default.conf</code>:</p>
<pre><code>rewrite ^/.well-known/caldav /SOGo/dav permanent;
</code></pre>
<p>Add a new line right after above line:</p>
<pre><code>rewrite ^/.well-known/caldav /SOGo/dav permanent;
rewrite ^/.well-known/carddav /SOGo/dav permanent;
</code></pre>
<p>Restarting Nginx service is required.</p>
<h3 id="sogo-the-dovecot-master-user-used-by-sogo-doesnt-work-due-to-incorrect-username">SOGo: The Dovecot Master User used by SOGo doesn't work due to incorrect username.</h3> <h3 id="sogo-the-dovecot-master-user-used-by-sogo-doesnt-work-due-to-incorrect-username">SOGo: The Dovecot Master User used by SOGo doesn't work due to incorrect username.</h3>
<p>Note: you can skip this step if you don't run SOGo groupware, and iRedMail <p>Note: you can skip this step if you don't run SOGo groupware, and iRedMail
doesn't install SOGo on FreeBSD due to missing required ports in official ports doesn't install SOGo on FreeBSD due to missing required ports in official ports