nixos-mailserver/README.md

98 lines
3.5 KiB
Markdown
Raw Permalink Normal View History

2017-09-13 14:03:04 +02:00
# ![Simple Nixos MailServer][logo]
2016-07-21 18:55:01 +02:00
![license](https://img.shields.io/badge/license-GPL3-brightgreen.svg)
[![pipeline status](https://gitlab.com/simple-nixos-mailserver/nixos-mailserver/badges/master/pipeline.svg)](https://gitlab.com/simple-nixos-mailserver/nixos-mailserver/commits/master)
2016-07-21 18:11:43 +02:00
2017-09-13 14:03:04 +02:00
## Release branches
For each NixOS release, we publish a branch. You then have to use the
SNM branch corresponding to your NixOS version.
2024-06-03 11:57:22 +02:00
* For NixOS 24.05
- Use the [SNM branch `nixos-24.05`](https://gitlab.com/simple-nixos-mailserver/nixos-mailserver/-/tree/nixos-24.05)
- [Documentation](https://nixos-mailserver.readthedocs.io/en/nixos-24.05/)
- [Release notes](https://nixos-mailserver.readthedocs.io/en/nixos-24.05/release-notes.html#nixos-24-05)
2023-12-19 23:07:52 +01:00
* For NixOS 23.11
- Use the [SNM branch `nixos-23.11`](https://gitlab.com/simple-nixos-mailserver/nixos-mailserver/-/tree/nixos-23.11)
- [Documentation](https://nixos-mailserver.readthedocs.io/en/nixos-23.11/)
- [Release notes](https://nixos-mailserver.readthedocs.io/en/nixos-23.11/release-notes.html#nixos-23-11)
2020-05-22 14:52:45 +02:00
* For NixOS unstable
- Use the [SNM branch `master`](https://gitlab.com/simple-nixos-mailserver/nixos-mailserver/-/tree/master)
- [Documentation](https://nixos-mailserver.readthedocs.io/en/latest/)
2017-09-20 16:27:52 +02:00
2017-12-14 17:12:30 +01:00
[Subscribe to SNM Announcement List](https://www.freelists.org/list/snm)
This is a very low volume list where new releases of SNM are announced, so you
can stay up to date with bug fixes and updates.
2017-12-14 17:12:30 +01:00
2017-12-22 18:51:57 +01:00
2017-09-13 13:16:17 +02:00
## Features
2017-11-11 16:15:30 +01:00
### v2.0
2017-11-21 08:52:54 +01:00
* [x] Continous Integration Testing
2017-11-11 16:15:30 +01:00
* [x] Multiple Domains
2017-09-13 13:16:17 +02:00
* Postfix MTA
- [x] smtp on port 25
2020-07-06 10:38:12 +02:00
- [x] submission tls on port 465
- [x] submission starttls on port 587
2017-08-13 12:58:00 +02:00
- [x] lmtp with dovecot
* Dovecot
2017-09-13 13:16:17 +02:00
- [x] maildir folders
2020-07-06 10:38:12 +02:00
- [x] imap with tls on port 993
- [x] pop3 with tls on port 995
- [x] imap with starttls on port 143
- [x] pop3 with starttls on port 110
2017-08-13 12:58:00 +02:00
* Certificates
- [x] manual certificates
- [x] on the fly creation
2017-11-11 16:15:30 +01:00
- [x] Let's Encrypt
2017-08-13 12:58:00 +02:00
* Spam Filtering
2017-09-13 13:16:17 +02:00
- [x] via rspamd
2017-08-13 12:58:00 +02:00
* Virus Scanning
2017-09-13 13:16:17 +02:00
- [x] via clamav
2017-08-13 12:58:00 +02:00
* DKIM Signing
2017-09-13 13:16:17 +02:00
- [x] via opendkim
2017-08-13 12:58:00 +02:00
* User Management
2017-09-13 13:16:17 +02:00
- [x] declarative user management
- [x] declarative password management
2017-11-20 07:16:08 +01:00
* Sieves
- [x] A simple standard script that moves spam
- [x] Allow user defined sieve scripts
2018-01-07 13:15:36 +01:00
- [x] ManageSieve support
2017-12-20 08:40:58 +01:00
* User Aliases
- [x] Regular aliases
- [x] Catch all aliases
2017-09-13 13:16:17 +02:00
2017-11-11 16:15:30 +01:00
### In the future
2017-11-20 07:16:08 +01:00
2017-11-11 16:15:30 +01:00
* DKIM Signing
- [ ] Allow a per domain selector
2017-09-13 10:17:04 +02:00
### Get in touch
2017-09-13 10:17:04 +02:00
- Subscribe to the [mailing list](https://www.freelists.org/archive/snm/)
2021-06-06 10:21:14 +02:00
- Join the Libera Chat IRC channel `#nixos-mailserver`
2017-11-11 16:15:30 +01:00
2023-01-01 18:38:07 +01:00
## How to Set Up a 10/10 Mail Server Guide
2017-10-17 11:52:47 +02:00
2023-01-01 18:38:07 +01:00
Check out the [Setup Guide](https://nixos-mailserver.readthedocs.io/en/latest/setup-guide.html) in the project's documentation.
2017-08-12 11:52:01 +02:00
2023-01-01 18:38:07 +01:00
For a complete list of options, [see in readthedocs](https://nixos-mailserver.readthedocs.io/en/latest/options.html).
2018-02-28 14:07:50 +01:00
## Development
2017-11-10 17:16:21 +01:00
2023-05-23 23:06:06 +02:00
See the [How to Develop SNM](https://nixos-mailserver.readthedocs.io/en/latest/howto-develop.html) documentation page.
2020-05-22 14:52:45 +02:00
2017-09-03 15:43:37 +02:00
## Contributors
2020-05-26 21:00:37 +02:00
See the [contributor tab](https://gitlab.com/simple-nixos-mailserver/nixos-mailserver/-/graphs/master)
2017-11-21 12:07:07 +01:00
2017-11-21 09:45:59 +01:00
### Alternative Implementations
* [NixCloud Webservices](https://github.com/nixcloud/nixcloud-webservices)
2017-09-13 14:03:04 +02:00
### Credits
* send mail graphic by [tnp_dreamingmao](https://thenounproject.com/dreamingmao)
from [TheNounProject](https://thenounproject.com/) is licensed under
[CC BY 3.0](http://creativecommons.org/~/3.0/)
* Logo made with [Logomakr.com](https://logomakr.com)
2017-11-21 09:45:59 +01:00
2021-07-23 21:24:22 +02:00
[logo]: docs/logo.png