540 Commits (98d2d6f21289db4c61d5555127171192db7f5cc9)

Author SHA1 Message Date
lub 98a6ffb497 add compression via xz and lz4 4 years ago
bors[bot] 900d4f16ae
Merge #1684
1684: add warning about removing front r=mergify[bot] a=lub

## What type of PR?

documentation

## What does this PR do?

### Related issue(s)
- caused confusion e.g. in #1678

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] In case of feature or enhancement: documentation updated accordingly
- [ ] ~~Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.~~


Co-authored-by: lub <git@lubiland.de>
4 years ago
ebdavison ad97266f77
removing unneeded image
Removing this image as request in PR #1680
4 years ago
lub 900b28178a add warning about removing front 4 years ago
ebdavison 2cf9fdb220
remove service status "feature"
Per the issue tracker, this was removed in issue #463 (Remove the Service Status page)
4 years ago
Alexander Graf 0a907a744e updated documentation for config-dump 4 years ago
Alexander Graf dfc34b2165 Merge remote-tracking branch 'upstream/master' into import-export 4 years ago
Ciprian Pascu 45cdcbdab9
Update front.yaml
To match the other kubernetes objects' version
4 years ago
Dimitri Huisman 26839c9066 Fixed small typo, added clarification for full text search and added japanese local as a new feature. 4 years ago
Dario Ernst c0cc6bbaec Add DNS SPF upgrade notice; Extend Changelog items 4 years ago
Dario Ernst 2e55329b8b Improve changelog and release texts for 1.8 4 years ago
David Fairbrother e7caff9811 Add ability to set no WEBROOT_REDIRECT to Nginx
Adds a 'none' env option to WEBROOT_REDIRECT so that no `location /`
configuration is written to nginx.conf.

This is useful for setting up Mailu and Mailman where we override the
root to proxy to the mailing list server instead. Without this change
the nginx container will not start, or for 1.7 users can set their
WEBMAIL_PATH to / with no webmail to get the same results.

This fix means that future users don't have to choose between webmail
and a root override and makes the configuration intention clear.
4 years ago
Dimitri Huisman 17cea83301 Completely remove step 5 where you can set the replica count for docker-stack.
Add additional warning to ´experimental' notice in setup for stack.
Add a notice the shipped PostgreSQL is deprecated.
Make the external PostgreSQL database the default option.
Make 1.7 the default version (stable_version': '1.7', in docs\conf.py)
Update mergify.yml with 1.8 version
4 years ago
Dimitri Huisman 78890a97ff Preparations for 1.8 release. 4 years ago
Patryk Tech ef71bc04cb Update docs/reverse.rst with Traefik v2+ info 4 years ago
Alexander Graf 45bf6d1b4a Merge remote-tracking branch 'upstream/master' into import-export 4 years ago
bors[bot] 62c54ea57f
Merge #1592
1592: Add documentation for the web administration gui. r=mergify[bot] a=Diman0

## What type of PR?

Documentation

## What does this PR do?

This PR adds the section Web Administration Interface to the documentation site which completely documents all available settings in the web administration interface.

### Related issue(s)
- Closes issue #1590 (please close this issue for me)

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [ Done ] In case of feature or enhancement: documentation updated accordingly
- [ Done ] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Dimitri Huisman <diman@huisman.xyz>
Co-authored-by: Dimitri Huisman <52963853+Diman0@users.noreply.github.com>
4 years ago
Dimitri Huisman 86d6caa789
Update docs/webadministration.rst
additional clarification. We only support secure connections.

Co-authored-by: lub <github@lubiland.de>
4 years ago
Dimitri Huisman a50e6d55c5
Update docs/webadministration.rst
grammar

Co-authored-by: lub <github@lubiland.de>
4 years ago
Dimitri Huisman 5981a34397
Update docs/webadministration.rst
typo/grammar

Co-authored-by: lub <github@lubiland.de>
4 years ago
Dimitri Huisman 4a3b16d3bc
Update docs/webadministration.rst
typo/grammar

Co-authored-by: lub <github@lubiland.de>
4 years ago
Dimitri Huisman 04436dd047
Update docs/webadministration.rst
additional clarification

Co-authored-by: lub <github@lubiland.de>
4 years ago
Dimitri Huisman 037a7a40e7
Update docs/webadministration.rst
additional clarification

Co-authored-by: lub <github@lubiland.de>
4 years ago
Dimitri Huisman 465540229a
Update docs/webadministration.rst
Co-authored-by: lub <github@lubiland.de>
4 years ago
Dimitri Huisman 5c4a8069e4 Add additional instructions for first time usage. 4 years ago
Dimitri Huisman 9fe750dc2b Add FAQ entry for how to use webdav(radicale) 4 years ago
Dimitri Huisman f843bfe9d5 Add additional clarification that you may have to add a new domain to HOSTNAMES in your mailu.env file. 4 years ago
Dimitri Huisman 769a143e45
Update docs/webadministration.rst
typo

Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Dimitri Huisman 98f59a8763
Update docs/webadministration.rst
typo

Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Dimitri Huisman 2387e53c58
Update docs/webadministration.rst
More clarification.

Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Dimitri Huisman ec711cf021
Update docs/webadministration.rst
rewording to add more clarification

Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Dimitri Huisman 5f8e98c70f
Update docs/webadministration.rst
rewording to make it more clear

Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Dimitri Huisman 1083527647
Update docs/webadministration.rst
rewording to make it more clear.

Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Dimitri Huisman a772c19546
Update docs/webadministration.rst
Rewording to make it more clear.

Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Dimitri Huisman 4bc0962fb8
Update docs/webadministration.rst
typo

Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Dimitri Huisman 9f4e906534
Update docs/webadministration.rst
Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Simonmicro 4a5678f571
Added explaining message about the current ipv6 problem 4 years ago
Alexander Graf 8e14aa80ee documented options and added help text 4 years ago
lub f0f873ffe7 add option to enforce inbound starttls 4 years ago
lub 426355f6b8 add some docs about _FILE variables 4 years ago
Alexander Graf 85de702129 small typo. Change 'omitting' to 'commiting' 4 years ago
bors[bot] 550065b043
Merge #1601
1601: Fixing documentation minor typo r=mergify[bot] a=akevinieron

## What type of PR?
Documentation

## What does this PR do?
Fixing minor typo on certificate section

## Related issue(s)
N/A

Co-authored-by: Kevin Jimenez <kevinjimenezlorenzo@gmail.com>
4 years ago
Alexander Graf bc9362685b Merge remote-tracking branch 'upstream/master' into import-export 4 years ago
Alexander Graf 3a5a15a5e6 updated documentation and changelog
added some documentation for cli commands config-dump and config-update
4 years ago
Alexander Graf 669d8da9ac fixed workflow example in documentation
use "git remote add" instead of "git add remote"
4 years ago
Kevin Jimenez b86dc12c1f
Fixing documentation minor typo 4 years ago
bors[bot] ac3dfd5cde
Merge #1553
1553: Added FAQ about SMTP Banner r=mergify[bot] a=arother

## What type of PR?
documentation

## What does this PR do?
Adding FAQ about SMTP Banner

### Related issue(s)
- closes #1368 

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

Co-authored-by: Andreas Rother <andreas@rother.org>
Co-authored-by: Dario Ernst <github@kanojo.de>
4 years ago
Dario Ernst bf8acbb343
Remove section about hostname change
Changing Hostname in the .env and in the banner might lead to various breakages of the setup — so don’t advise it to users in the FAQ.

Co-authored-by: Thomas Sänger <thomas@gecko.space>
4 years ago
Dimitri Huisman b3e9e1bd1a Add documentation for the web administration gui. 4 years ago
Dimitri Huisman 1544bc4a95 Add documentation in regard to the spam filter in Mailu. Added all suggestions from Liquidat and Nebukadneza.. 4 years ago
bors[bot] 72f997d4ea
Merge #1570
1570: Update webmail.yaml r=mergify[bot] a=DerH4NNES

Duplicated "ports:"

## What type of PR?

bug-fix

## What does this PR do?
fixes service specs
### Related issue(s)
/

Co-authored-by: Sascha Hannes <saschahannes@web.de>
4 years ago
bors[bot] 535b95bca7
Merge #1538
1538: Introduce environment variable to control dovecot full-text-search r=mergify[bot] a=tremlin

## What type of PR?

Enhancement

## What does this PR do?

In #1320 a full-text-search feature was enabled in Dovecot by default. Since this can have a big impact on performance, I think it's preferable to offer an option to disable the feature if it is not needed. This PR doesn't change the default behavior (FTS on).

### Related issue(s)
- #1320

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [ ] In case of feature or enhancement: documentation updated accordinagly
- [ ] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Thomas Rehn <thomas.rehn@initos.com>
4 years ago
bors[bot] 27b6016bc6
Merge #1499
1499: Harmonization of the various docker-compose.yml templates r=mergify[bot] a=ofthesun9

## What type of PR?
Mainly documentation and update of the docker-compose.yml templates

## What does this PR do?
- Update of setup/flavors/stack/docker-compose.yml and docs/compose/docker-compose.yml to keep parity with setup/flavors/compose/docker-compose.yml (last changes with pr1444)
- Also refresh of the mkdir command found in setup/flavors/stack/setup.html to cope with the creation of mailqueue; overrides/nginx, overrides/dovecot folders.

### Related issue(s)
None

## Prerequistes
- [x] In case of feature or enhancement: documentation updated accordingly



Co-authored-by: ofthesun9 <olivier@ofthesun.net>
4 years ago
bors[bot] 64f21d5b84
Merge #1478 #1501 #1532 #1543
1478: Allow to enforce TLS for outbound r=mergify[bot] a=micw

 using OUTBOUND_TLS_LEVEL=encrypt (default is 'may')

## What type of PR?

enhancement

## What does this PR do?

Add an option to postfix to enforce outbound traffic to be TLS encrypted.

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


1501: In setup/flavor, change DMARC RUA and RUF email default settings r=mergify[bot] a=ofthesun9

## What type of PR?
bug-fix

## What does this PR do?
This PR changes the default value used to set DMARC_RUA and DMARC_RUF:
DMARC_RUA and DMARC_RUF defaults will reuse the value defined for POSTMASTER,
instead of 'admin' as previously.
Please note that the setup tool doesn't allow (yet?) to define dmarc_rua nor dmarc_ruf, so the default value is indeed used for the time being.

### Related issue(s)
closes #1463 

## Prerequistes
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


1532: Replace SMPT with SMTP r=mergify[bot] a=dhoppe



1543: Disable Health checks on swarm mode r=mergify[bot] a=ofthesun9

ref: https://github.com/moby/moby/issues/35451

## What type of PR?
bug-fix

## What does this PR do?
Modify the docker-compose.yml template used by setup (swarm flavor) to disable Health checks on swarm mode for each service

### Related issue(s)
closes #1289

## Prerequistes
- [x]  add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Michael Wyraz <michael@wyraz.de>
Co-authored-by: ofthesun9 <olivier@ofthesun.net>
Co-authored-by: Dennis Hoppe <github@debian-solutions.de>
4 years ago
Sascha Hannes f1e8c812aa
Update webmail.yaml
Duplicated "ports:"
4 years ago
Thomas Rehn ebf1f4f1b6 add bits of documentation for new environment variable 4 years ago
Andreas Rother dd1be737c4
Added FAQ about SMTP Banner 4 years ago
ofthesun9 693fb3dbc7 Harmonization of the various docker-compose.yml
Harmonization (following pr1444) between:
 - docs/compose/docker-compose.yml
 - setup/flavors/stack/docker-compose.yml
 - setup/flavors/compose/docker-compose.yml
Also refresh of the mkdir command found in setup/flavors/stack/setup.html
5 years ago
bors[bot] 68bf16076a
Merge #1470
1470: Adding faq entry: How to teach Bayes ham and spam #1438 r=muhlemmer a=ofthesun9

Fix #1438

## What type of PR?
documentation (faq)

## What does this PR do?
This PR add an faq entry to cover #1438 

### Related issue(s)
closes #1438 

## Prerequistes
- [x] In case of feature or enhancement: documentation updated accordingly



Co-authored-by: ofthesun9 <olivier@ofthesun.net>
5 years ago
ofthesun9 819fa94cb1
Update docs/faq.rst
Co-authored-by: Tim Möhlmann <muhlemmer@gmail.com>
5 years ago
ofthesun9 7bc46baae0
Update docs/faq.rst
Co-authored-by: Tim Möhlmann <muhlemmer@gmail.com>
5 years ago
ofthesun9 7700215ff7
Update docs/faq.rst
Co-authored-by: Tim Möhlmann <muhlemmer@gmail.com>
5 years ago
Michael Wyraz 6234da3786 Add doc and changelog for OUTBOUND_TLS_LEVEL 5 years ago
ofthesun9 c7fa8fda17 Modify faq entry to match new overrides settings for dovecot and postfix (#1444) 5 years ago
bors[bot] 10e17fbb0b
Merge #1444
1444: Harden default configuration r=mergify[bot] a=Jarel1337



Co-authored-by: Vilgot Fredenberg <vilgot@fredenberg.xyz>
Co-authored-by: Tim Möhlmann <muhlemmer@gmail.com>
5 years ago
ofthesun9 888ce1b2e0 Adding faq entry to cover #1438
Fix #1438
5 years ago
Tim Möhlmann 19afa8b270
Docs: Add move of override files to release notes 5 years ago
bors[bot] 5798880f08
Merge #1423
1423: Doc update: proxy_set_header required for admin r=mergify[bot] a=ofthesun9

Copy Paste of an existing PR whose upstream branch is gone
Fix #1318

## What type of PR?

documentation

## What does this PR do?

### Related issue(s)
closes #1318  (copy paste of 1318)

## Prerequistes
- [x ] In case of feature or enhancement: documentation updated accordingly
- [x ] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: ofthesun9 <olivier@ofthesun.net>
5 years ago
bors[bot] 3dc9287e4f
Merge #1410
1410: Updated url for cert-manager doc r=mergify[bot] a=tuxfanou

Provided url does not exists anymore.

Replace pull request #1404 

Co-authored-by: Stéphane Burdin <steph@tux.tf>
5 years ago
ofthesun9 ab40d03cc6 Doc update: proxy_set_header required for admin
Copy Paste of an existing PR whose upstream branch is gone
Fix #1318
5 years ago
Stéphane Burdin b8263ee49e Updated url for cert-manager doc
Provided url does not exists anymore.
5 years ago
bors[bot] d883ba1bed
Merge #1385
1385: [docs] fix variable name for RECIPIENT_DELIMETER r=Nebukadneza a=eleith

## What type of PR?

documentation

## What does this PR do?

the variable name as referenced by postfix and dovecot and mailu.env are all `RECIPIENT_DELIMETER`

example, see: 

dcda412b99/core/postfix/conf/main.cf (L40)



Co-authored-by: eleith <eleith@users.noreply.github.com>
5 years ago
bors[bot] 58ce6fb930
Merge #1333
1333: Fix bad file path in documentation r=mergify[bot] a=NeroPcStation

## What type of PR?

documentation

## What does this PR do?

### Related issue(s)
-  #1263




Co-authored-by: NeroPcStation <neroxbox28@gmail.com>
5 years ago
eleith 97eda85db8 fix variable name for RECIPIENT_DELIMETER
the variable name as referenced by postfix (dcda412b99/core/postfix/conf/main.cf (L40)) and others is `RECIPIENT_DELIMETER`.
5 years ago
Dario Ernst afec5f08fb Remove duplicate ports line
closes #1079
5 years ago
bors[bot] b8b1699f9e
Merge #1359
1359: Refactor the rate limiting code r=mergify[bot] a=kaiyou

## What type of PR?

Enhancement

## What does this PR do?

Rate limiting was already redesigned to use Python limits. This
introduced some unexpected behavior, including the fact that only
one criteria is supported per limiter. Docs and setup utility are
updated with this in mind.

Also, the code was made more generic, so limiters can be delivered
for something else than authentication. Authentication-specific
code was moved directly to the authentication routine.

### Related issue(s)

No specific issue.

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: kaiyou <pierre@jaury.eu>
5 years ago
kaiyou 8e88f1b8c3 Refactor the rate limiting code
Rate limiting was already redesigned to use Python limits. This
introduced some unexpected behavior, including the fact that only
one criteria is supported per limiter. Docs and setup utility are
updated with this in mind.

Also, the code was made more generic, so limiters can be delivered
for something else than authentication. Authentication-specific
code was moved directly to the authentication routine.
5 years ago
bors[bot] 770d09b05b
Merge #1351
1351: Add some faq entries r=hoellen a=kaiyou

## What type of PR?

Documentation

## What does this PR do?

Add missing faq entries

### Related issue(s)
- Closes: #853 
- Closes: #897 
- Closes: #1090 
- Closes: #1315

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: kaiyou <pierre@jaury.eu>
5 years ago
kaiyou 76d2094b07 Apply suggestions from code review
Co-Authored-By: hoellen <hoellen@users.noreply.github.com>
5 years ago
kaiyou a39249a43a
Update docs/faq.rst
Co-Authored-By: hoellen <hoellen@users.noreply.github.com>
5 years ago
bors[bot] 00d49e2986
Merge #1350
1350: Update the tlv1 faq to indicate that a full config rewrite is required r=mergify[bot] a=kaiyou

## What type of PR?

Documentation

## What does this PR do?

Update the tlv1 faq to indicate that a full config rewrite is required

### Related issue(s)
- Closes: #944 

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: kaiyou <pierre@jaury.eu>
5 years ago
kaiyou 6edf7a7896 Add some faq entries 5 years ago
kaiyou 450be78898 Update the tlv1 faq to indicate that a full config rewrite is required 5 years ago
NeroPcStation 0593ccd9f0
Fix bad file path in documentation 5 years ago
bors[bot] 96f832835a
Merge #1278
1278: Limiter implementation r=kaiyou a=micw

## What type of PR?

(Feature, enhancement, bug-fix, documentation)

## What does this PR do?

Adds a custom limter based on the "limits" lirary that counts up on failed auths only

### Related issue(s)
- closes #1195
- closes #634

## Prerequistes

- [X] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Michael Wyraz <michael@wyraz.de>
Co-authored-by: micw <michael@wyraz.de>
5 years ago
iohenkies ae6f82984d Add Fail2Ban section 5 years ago
bors[bot] 9db709515a
Merge #1308
1308: Use redis 5 on k8s & add selector r=mergify[bot] a=der-eismann

## What type of PR?
Enhancement

## What does this PR do?
This PR is updating Redis to version 5 in the kubernetes manifests. It is already used in the compose and swarm files, so I don't expect any incompatibilities. There is no necessary migration, you just can't go back.
In addition I added a selector to the manifest and applied a consistent formatting.

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [ ] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Philipp Trulson <philipp@trulson.de>
5 years ago
Nils Jakobi c4fbc93171
Fixed small typo 5 years ago
Philipp Trulson 3b9281501a Use redis 5 on k8s & add selector 5 years ago
AndreKoepke b42b48b836
Update database.rst
Correct keyword for postgresql-flavor
5 years ago
Michael Wyraz 70f797dbd9 Don't raise rate limit exception on hit(), only on check() 5 years ago
bors[bot] f8a5dd000e
Merge #1241
1241: Change extensions/v1beta to apps/v1 to be compliant with Kubernetes 1.16 r=mergify[bot] a=WebSpider


## What type of PR?

Enhancement

## What does this PR do?

Changes to Kubernetes YAML files to be able to use this in Kubernetes 1.16

### Related issue(s)
- Fixes #1237

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- N/A In case of feature or enhancement: documentation updated accordingly
- [X] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: WebSpider <webspider@bitlair.nl>
Co-authored-by: micw <michael@wyraz.de>
5 years ago
bors[bot] cfd838f310
Merge #1215
1215: Allow specifying the traefik version for cert dumping r=mergify[bot] a=timoschwarzer

## What type of PR?

Enhancement

## What does this PR do?

### Related issue(s)
- #1011 

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [X] In case of feature or enhancement: documentation updated accordingly
- [X] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Timo Schwarzer <me@timoschwarzer.com>
5 years ago
Michael Wyraz e857b9d659 Document default antivirus behaviour, add an option to reject viruses 5 years ago
micw 72235babdf
Update docs/dns.rst
Co-Authored-By: hoellen <hoellen@users.noreply.github.com>
5 years ago
Michael Wyraz 6aaa85b1a2 Document reverse DNS setup recommendations 5 years ago
WebSpider 95d03f4b4a Change extensions/v1beta to apps/v1 to be compliant with Kubernetes 1.16
Fixes #1237
5 years ago
bors[bot] e3b98e1353
Merge #1229
1229: Fix docs warnings r=mergify[bot] a=muhlemmer

## What type of PR?

Documentation

## What does this PR do?

1. Fix various build warnings from Sphinx that sneaked into the project over time, and fixed them. 
2. Enable the `-W` option for `sphinx-build` to elevate `warning` to `error` in order to make build fail in case of syntax errors. This will give a better feedback from Travis to Pull Requests with Documentation updates. They will now block in case of syntax errors, so we don;t have to cleanup afterwards.

### Related issue(s)
None

## Prerequistes
N/A


Co-authored-by: Tim Möhlmann <muhlemmer@gmail.com>
5 years ago
Tim Möhlmann d94c8bce53
Docs: treat warnings as errors 5 years ago
Tim Möhlmann 4911fba4af
Docs: Fix various build warnings:
- /docs/configuration.rst:157: WARNING: Inline emphasis start-string without end-string.
- /docs/configuration.rst:159: WARNING: Inline emphasis start-string without end-string.
- /docs/configuration.rst:159: WARNING: Inline emphasis start-string without end-string.
- /docs/configuration.rst:159: WARNING: Inline emphasis start-string without end-string.
- /docs/rpi_build.rst: WARNING: document isn't included in any toctree
5 years ago
Tim Möhlmann 45e0739302
Funding related documentation 5 years ago
bors[bot] 89413a8da9
Merge #1151
1151: Start writing the contribution guidelines r=mergify[bot] a=kaiyou

## What type of PR?

Documentation

## What does this PR do?

It provides a first suggested version of contribution guidelines for the project. These are very open do discussion. This was suggested in #1133.

## Prerequistes

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: kaiyou <pierre@jaury.eu>
5 years ago
bors[bot] 0417c791ff
Merge #985
985: Permit raspberry pi (and other architectures) builds r=mergify[bot] a=abondis

## What type of PR?

Enhancement

## What does this PR do?

Add an option to select base images and permit building for different CPU architectures.

### Related issue(s)
N/A

## Prerequistes

- [X] documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Aurélien Bondis <aurelien.bondis@gmail.com>
Co-authored-by: Aurelien <aurelien.bondis@gmail.com>
5 years ago
bors[bot] dcda412b99
Merge #1211
1211: Split HOST_ANTISPAM in HOST_ANTISPAM_MILTER and HOST_ANTISPAM_WEBUI r=mergify[bot] a=micw

## What type of PR?

bug-fix

## What does this PR do?

Fixes #1190 by separating HOST_ANTISPAM into HOST_ANTISPAM_MILTER and HOST_ANTISPAM_WEBUI

### Related issue(s)
- closes #1190
- closes #1150

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [ ] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Michael Wyraz <michael@wyraz.de>
5 years ago
Timo Schwarzer 0c82caf817
Allow specifying the traefik version for cert dumping 5 years ago
bors[bot] 35160b770d
Merge #1198 #1204 #1207 #1208
1198: Enable access log of admin service only for log levels of INFO and finer r=muhlemmer a=micw

## What type of PR?

bug fix

## What does this PR do?

### Related issue(s)
- closes #1197

## Prerequistes

- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


1204: Add initial admin account to kubernetes example r=muhlemmer a=micw

## What type of PR?

documentation

## What does this PR do?

Add INITIAL_ADMIN_* example to kubernetes configmap.yaml

### Related issue(s)

- closes #1201

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- docs example only

1207: Add Japanese translation r=muhlemmer a=IchikawaYukko

## What type of PR?

Translation

## What does this PR do?

Provide completed Japanese translation.

### Related issue(s)

None

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [*] In case of feature or enhancement: documentation updated accordingly
- [*] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


1208: Persist mailqueue r=muhlemmer a=micw

## What type of PR?

bug-fix

## What does this PR do?

Makes postfix mailqueue presistent (for docker, swarm and kubernetes)

### Related issue(s)
- closes #1161

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Michael Wyraz <michael@wyraz.de>
Co-authored-by: Michael Wyraz <michael.wyraz@evermind.de>
Co-authored-by: U-COREI3-3120M\市川ゆり子 <ichikawayuriko@yahoo.co.jp>
Co-authored-by: micw <michael@wyraz.de>
5 years ago
Michael Wyraz a907fe4cac Split HOST_ANTISPAM in HOST_ANTISPAM_MILTER and HOST_ANTISPAM_WEBUI 5 years ago
micw cdb9681674
Update smtp.yaml
Remove unused volume from smtp.yaml
5 years ago
bors[bot] f6e6380154
Merge #1188
1188: You have to delete the Admin Pod, not the Imap pod r=muhlemmer a=fionera

## What type of PR?

documentation

## What does this PR do?

### Related issue(s)

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [ ] In case of feature or enhancement: documentation updated accordingly
- [ ] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Fionera <fionera@fionera.de>
5 years ago
Aaron E-J 065d22db66
changed the most recent stable version to 1.7 5 years ago
Michael Wyraz b625b1eaea Add postfix mailqueue to persistent storage on kubernetes 5 years ago
Michael Wyraz d9374e3c80 Add initial admin account to kubernetes example 5 years ago
Aurélien Bondis 5066129df0 RPi: update doc (alpine version + variables) 5 years ago
bors[bot] 20e00ac0c4
Merge #1158
1158: Use nginx for kubernetes ingress r=kaiyou a=micw

## What type of PR?

enhancement

## What does this PR do?

Currently, kubernetes uses a complex ingress setting which is not portable across different ingress controllers. This PR simplifies the ingress and delegates everythins special to Mailu to the front container,

### Related issue(s)
- closes #1121
- closes #1117
- closes #1021
- closes #1045

## Prerequistes

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog]

Co-authored-by: Michael Wyraz <michael@wyraz.de>
5 years ago
Michael Wyraz b94636b883 Add port 80 to front container and service 5 years ago
Michael Wyraz 44837fc007 Switch from host network to hostPort bindings 5 years ago
Fionera 7a8395c927
Update index.rst 5 years ago
kaiyou d5ad1cb449 Fix many typos and take the review into account 5 years ago
Michael Wyraz 92645bcd4a Use nginx for kubernetes ingress 5 years ago
kaiyou 488dfc2572 Start writing the contribution guidelines 5 years ago
Michael Wyraz de2f166bd1 Resolve HOST_* to *_ADDRESS only if *_ADDRESS is not already set 5 years ago
Tim Möhlmann 1f0b45e47b
Release notes: remove spaces before bullet list 5 years ago
Tim Möhlmann 3320820f16
Docs: fix rendering in release notes 5 years ago
bors[bot] 13072d5144
Merge #1144
1144: Add proper release notes for 1.7 r=mergify[bot] a=kaiyou

## What type of PR?

Documentation

## What does this PR do?

When first writing the release notes, I forgot to include a proper release notes section in the docs.

### Related issue(s)

None

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [ ] In case of feature or enhancement: documentation updated accordingly
- [ ] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: kaiyou <pierre@jaury.eu>
5 years ago
kaiyou a640756b7f Add proper release notes for 1.7 5 years ago
Tim Möhlmann a09d166dbf
Docs: fix some build warnings
I've noticed some styling / flow errors on the FAQ page on mailu.io.
This was due to short underlining.
Spynx was complaining about this at build time.
5 years ago
Tim Möhlmann fdec33d419
1.7 stable in docs 🚀 5 years ago
Igor Rzegocki 6f973a2e4b
Fixed hardcoded antispam and antivirus host addresses
Fixes #978
5 years ago
bors[bot] 2785bca1f4
Merge #883
883: Admin create user enhancement r=mergify[bot] a=cr1st1p

## What type of PR?
Enhancement

## What does this PR do?
It allows the admin docker image to also create the admin user.
The idea is that in my kubernetes setup, I do not want to manually do anything, as such, I need a way for the admin user to also be created automatically without me getting inside the pod.
So I had to change the manage.py function that creates the user to allow different 'modes' (me, I'll be using 'ifmissing') and also start.py to call that functionality if appropriate environment variables are present.

So now, in my Deployment, I add 3 more environment variables and I get the admin user created, IF not already present.

### Related issue(s)
none?

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: place entry in the [changelog](CHANGELOG.md), under the latest un-released version.


Co-authored-by: cristi <cristi.posoiu@gmail.com>
Co-authored-by: cr1st1p <cristi.posoiu@gmail.com>
Co-authored-by: Tim Möhlmann <muhlemmer@gmail.com>
5 years ago
Aurélien Bondis 42e520843e update docs 5 years ago
Aurélien Bondis a053f90875 docs: user ARG to chose image, install python3 before running pip3 5 years ago
Ionut Filip be1873e1e8 Update docs, travis and mergify for 1.7 release 5 years ago
bors[bot] 55cdea974a
Merge #1078
1078: expose pop3 port, remove imap-ssl from dovecot in kubernetes manifest r=mergify[bot] a=sbias

## What type of PR?
bug-fix

## What does this PR do?
Exposes provided pop3 service in service definition to get useable by front

Co-authored-by: sbias <sb@liztv.net>
5 years ago
sbias 83c58c6ed5
add names to ports of imap deployment, remove imap-ssl 5 years ago
Dennis Boldt a5610d3c25
Fixed C&P issue 5 years ago
Dennis Boldt eaeb151ff7
Use default key/cert names (cert.pem & key.pem) 5 years ago
Dennis Boldt 841ce96fbf
Update mount path to mailu/certs
- Thus, we write to /data/mailu/certs, since LE uses the same location
- The dumper created cert.pem and key.pem
- Mount /data/mailu/certs to certs, where nginx picks them up
5 years ago
Dennis Boldt a9089710c8
Fix key-certificate pair names and paths 5 years ago
Dennis Boldt 982caa0e42
Clean up folders, which traefik-certdumper uses 5 years ago
sbias 173b9bdc6d
expose pop3 port 5 years ago
hoellen 616d40d225 Update password in commandline 5 years ago
Daniel Huber 515e95076a
Merge branch 'master' into feat-relay-auth 5 years ago
bors[bot] 607799ea5e Merge #1030
1030: Update user_external example for nextcloud r=mergify[bot] a=kesselb

## What type of PR?

documentation

## What does this PR do?

Update the user_external example for Nextcloud due an upstream change. PHP will remove the imap extension. Newer user_external releases requires a different configuration for imap.

### Related issue(s)
- https://github.com/nextcloud/user_external/issues/52

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Daniel Kesselberg <mail@danielkesselberg.de>
5 years ago
bors[bot] d27417952f Merge #1029
1029: Corrected 'adminitration' to 'administration' r=mergify[bot] a=warsix4

## What type of PR?

documentation/bug-fix

## What does this PR do?

'adminitration' has been corrected to 'administration'

### Related issue(s)


## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [ ] In case of feature or enhancement: documentation updated accordingly
- [ ] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: Cody Warmbo <github@warmbo.com>
5 years ago
bors[bot] 2d4c837761 Merge #1015
1015: Merge DNS hints, and hostname/domain ordering hints. r=Nebukadneza a=toxik-io

## Enhancement - Hints in setup, references in setup & DNS docs

Unrelated: This PR makes changes to the Flask setup utilities to suggest ordering the `HOSTNAMES` 
entry so that the first entry is the admin panel's domain (at least in my experience that's what fixed my
issues)

It also makes changes to the documentation, referencing that more than the usual DNS
entries need to be set (and the admin panel used) if they've enabled DMARC/SPF/DKIM.

### Related issue(s)
- My original issue #1002

## Prerequistes

- [x] In case of feature or enhancement: documentation updated accordingly
- [ ] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.

## Assistance
I'm unsure if the hints for HOSTNAME ordering are simply because of how the config is gulped in
by the current tooling, or if it's a bug that the frontend only accepts connections from the first host...

I also don't know what commands in the CLI would replicate the steps taken on the admin dashboard.

Further, I don't know what you'd put in the changelog.

Co-authored-by: toxik-io <thetoxicarcade@gmail.com>
5 years ago
Daniel Kesselberg 591f00a711
Change NextCloud to Nextcloud 5 years ago
Daniel Kesselberg 6cad9f4839
Improve wording 6 years ago
Daniel Kesselberg 8088f2bd6d
Improve readability 6 years ago
Daniel Kesselberg 04a66187b5
Add information about stripDomain 6 years ago
bors[bot] ccecf3449e Merge #1010
1010: Move the localization effort to Weblate r=mergify[bot] a=kaiyou

## What type of PR?

documentation

## What does this PR do?

This PR updates documentation for us to move the localization effort outside of POEditor. POEditor had archived our project and it was linked to my account. I suggest we move to a Weblate instance (hosted at TeDomum for the part I setup).

### Related issue(s)
- closes #916 

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: add [changelog](https://mailu.io/master/contributors/guide.html#changelog) entry file.


Co-authored-by: kaiyou <pierre@jaury.eu>
6 years ago
Cody Warmbo 2277d86a9f Corrected 'adminitration' to 'administration' 6 years ago
hoellen 0f030130b4 [doc] port 443 instead of 440 6 years ago
Daniel Kesselberg b2b19d8810
Update user_external example for nextcloud 6 years ago
cristi 078082fac9 Hopefully improved documentation around initial admin account creation. 6 years ago
cristi f2a009795b Merge branch 'master' into admin_create_user_enhancement 6 years ago
toxik-io 6ca59f20b5
typo. 6 years ago
toxik-io 55224fb915
suggestion on fixing some access denied errors for admin. 6 years ago
toxik-io 5fe7fb4bf8
location in the admin UI to regenerate DMARC/SPF/DKIM 6 years ago
toxik-io 0f439dbc5b
DMARC regenerated in admin dash (what about cli?) 6 years ago
kaiyou 05925f4c45 Move the localization effort to Weblate 6 years ago
kaiyou 13d7dbdde5 Remove references to individuals in the docs 6 years ago
Daniel Huber 7dcb2eb006
Add authentication for email relays 6 years ago
bors[bot] 42953eb70b Merge #922
922: Add FAQ about clients on port 25 generating non-helpful errors r=mergify[bot] a=Nebukadneza

## What type of PR?
documentation

## Prerequistes
- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: place entry in the [changelog](CHANGELOG.md), under the latest un-released version.


Co-authored-by: Dario Ernst <dario@kanojo.de>
Co-authored-by: Ionut Filip <ionut.philip@gmail.com>
6 years ago
Ionut Filip b798ea94d2
Split quoted text on two lines and fix underlines 6 years ago
bors[bot] a44a34d20f Merge #936
936: Implement towncrier for changelog updates r=mergify[bot] a=ionutfilip

## What type of PR?
Feature

## What does this PR do?
Implements towncrier to create changelog entries

### Related issue(s)

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [ ] In case of feature or enhancement: documentation updated accordingly
- [ ] Unless it's docs or a minor change: place entry in the [changelog](CHANGELOG.md), under the latest un-released version.


Co-authored-by: Ionut Filip <ionut.philip@gmail.com>
6 years ago
Ionut Filip 8489bcb05e Minor changes to changelog doc 6 years ago
Ionut Filip e674a6fe3d Added docs for new changelog entries 6 years ago
Roman Hoellen 1dfef1609a add domain cli to docs 6 years ago
Roman Hoellen bc617cf8ec replace _ with - in cli options 6 years ago
Roman Hoellen ab33ba2172 Merge remote-tracking branch 'upstream/master' into fix-doc-commands-1 6 years ago
Adrian Gruntkowski 3cfaa00fac
Update command for user import
The current example seems to be obsolete.
6 years ago
Dario Ernst 328db51032 Add FAQ about clients on port 25 generating non-helpful errors 6 years ago
bors[bot] 86b4242f82 Merge #886
886: Ipv6 support r=mergify[bot] a=muhlemmer

## What type of PR?

(Feature, enhancement, bug-fix, documentation) -> A bit of everything

## What does this PR do?

Document how to use ipv6nat. This, however triggers some kind of flaky behavior with the Docker DNS resolver, resulting in lookup failures between containers.  So all resolving needs to be done during container startup/configuration.

In order not to pollute every single start.py file, we've created a small library called [Mailu/MailuStart](https://github.com/Mailu/MailuStart). As an addition, this library also defines the template generation function, including its logging facility.

Note: `docker-compose.yml` downgrade is necessary, as IPv6 settings are not supported by the Docker Compose file format 3 😞  

### Related issue(s)
Supersedes  PR #844
- Fixes #827 
- Hopefully helps with #829 and #834

## No backport yet

This PR directly imports MailuStart from git. This makes it a bit more simple to implement on the short term an do some testing and probably some future improvements. When everything is proved stable, we will create a proper PyPi package with versioning and consider back porting.

## Prerequistes
Before we can consider review and merge, please make sure the following list is done and checked.
If an entry in not applicable, you can check it or remove it from the list.

- [x] In case of feature or enhancement: documentation updated accordingly
- [x] Unless it's docs or a minor change: place entry in the [changelog](CHANGELOG.md), under the latest un-released version.


Co-authored-by: Ionut Filip <ionut.philip@gmail.com>
Co-authored-by: Tim Möhlmann <muhlemmer@gmail.com>
6 years ago
cristi cfbc38b956 Updated doc 6 years ago
Tim Möhlmann a731e04670
Update docs on review dissmissal and automatic rebuilds 6 years ago
hoellen 928b5470d4 fix some cli commands in the docs 6 years ago
Tim Möhlmann a9d368d2c9
Fix typo in docs 6 years ago
Tim Möhlmann 33db705194
Use bors-ng to create and upload test images
- Reinstate Travis deploy phase
- Better labeling of Mergify rules
- Automatic `bors try` by Mergify
- Explain bors in comment message
- Skip push for staging branch
- Re-update docs to current situation
6 years ago
Tim Möhlmann faca9983a8
Automatic creation of review images
- Enable bors-ng for better merging
- Re-enable mergify with a fixed up syntax, it will now only issue bors commands.
- Pull request build images are now pushed to docker hub
- Automatic backport rule
- Fix build tag for branches with slash (/)
- Only push when master and 1.6 target branch
6 years ago
bladeswords 3f5d08235b
Updated doc to reflect 1.6 release 6 years ago
Tim Möhlmann de8e6f74ea
1.6 release notes (#845)
* 1.6 release!
* Fix typo in release notes
* Rectify Alpine 3.8.2 in release notes
6 years ago
Ionut Filip bbbd22b3a3
Merge pull request #843 from usrpro/fix-unbound-swarm
Remove unbound from swarm
6 years ago
Tim Möhlmann d593c783a3
Fix typo in link 6 years ago
Tim Möhlmann 3460872747
Documentation on IPv6 6 years ago
Tim Möhlmann d9f8510bb6
Fix notls typo 6 years ago
Tim Möhlmann 711f2bcfaf
Docker swarm warnings 6 years ago
Tim Möhlmann 71ba016120
Unbound docs for Swarm 6 years ago
Tim Möhlmann 38e754be6d
Make docs refer to the setup utility 6 years ago
Tim Möhlmann 1975534125
Make docker-compose.yml for setup and docs development friendly
This enables easy local running.
Actual deployment files are moved to github.com/mailu/infra.
6 years ago
Dario Ernst 686db1f33f Add reminder for users not to forget POSTMASTER account or alias 6 years ago
Ionut Filip 50343f354e Merge remote-tracking branch 'upstream/master' into feat-psql-support 6 years ago
Ionut Filip 7f8c7b6479 Added documentation for external mysql db 6 years ago
Thomas Sänger 492f3867d8
remove (broken) FTS 6 years ago
Tim Möhlmann 71cda7983e
Merge branch 'master' into feat-logging 6 years ago
Tim Möhlmann 7d01bb2a4d
LOG_LEVEL docs and changelog entry 6 years ago
Ionut Filip 9077bf7313 Merge remote-tracking branch 'upstream/master' into feat-psql-support 6 years ago
Tim Möhlmann 4b0601cb64
Add WEBROOT_REDIRECT documentation
Closes #802
6 years ago
Ionut Filip 0764c81a57 Fixed typo 6 years ago
Ionut Filip 4e8f899b28 Updated faq with nextcloud integration 6 years ago
Tim Möhlmann fa355ff05a
Merge pull request #787 from usrpro/update-faq
Update faq
6 years ago