mirror of
https://blitiri.com.ar/repos/chasquid
synced 2025-12-18 14:47:03 +00:00
README: Match wording with website
Rewrite some of the paragraph to make them (hopefully) clearer, reorder the feature list in a 2-level structure for more legibility, reference the IRC channel, and other minor wording changes.
This commit is contained in:
63
README.md
63
README.md
@@ -1,10 +1,8 @@
|
|||||||
|
|
||||||
# chasquid
|
# chasquid
|
||||||
|
|
||||||
[chasquid](https://blitiri.com.ar/p/chasquid) is an SMTP (email) server.
|
[chasquid](https://blitiri.com.ar/p/chasquid) is an SMTP (email) server with a
|
||||||
|
focus on simplicity, security, and ease of operation.
|
||||||
It aims to be easy to configure and maintain for a small mail server, at the
|
|
||||||
expense of flexibility and functionality.
|
|
||||||
|
|
||||||
It's written in [Go](https://golang.org), and distributed under the
|
It's written in [Go](https://golang.org), and distributed under the
|
||||||
[Apache license 2.0](http://en.wikipedia.org/wiki/Apache_License).
|
[Apache license 2.0](http://en.wikipedia.org/wiki/Apache_License).
|
||||||
@@ -14,37 +12,39 @@ It's written in [Go](https://golang.org), and distributed under the
|
|||||||
[](https://goreportcard.com/report/github.com/albertito/chasquid)
|
[](https://goreportcard.com/report/github.com/albertito/chasquid)
|
||||||
[](https://coveralls.io/github/albertito/chasquid?branch=next)
|
[](https://coveralls.io/github/albertito/chasquid?branch=next)
|
||||||
[](https://godoc.org/blitiri.com.ar/go/chasquid)
|
[](https://godoc.org/blitiri.com.ar/go/chasquid)
|
||||||
|
[](https://webchat.freenode.net?channels=%23chasquid)
|
||||||
|
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
* Easy to configure.
|
* Easy
|
||||||
* Hard to mis-configure in ways that are harmful or insecure (e.g. no open
|
* Easy to configure.
|
||||||
relay, or clear-text authentication).
|
* Hard to mis-configure in ways that are harmful or insecure (e.g. no open
|
||||||
* Tracking of per-domain TLS support, prevents connection downgrading.
|
relay, or clear-text authentication).
|
||||||
* International usernames ([SMTPUTF8]) and domain names ([IDNA]).
|
* Monitoring HTTP server, with exported variables and tracing to help
|
||||||
* Hooks for easy integration with greylisting, anti-virus and anti-spam.
|
debugging.
|
||||||
* Multiple domains, with per-domain user database and aliases.
|
* Integrated with [Debian] and [Ubuntu].
|
||||||
* Multiple TLS certificates.
|
* Supports using [Dovecot] for authentication (experimental).
|
||||||
* Suffix dropping (`user+something@domain` → `user@domain`).
|
* Useful
|
||||||
* Easy integration with [Let's Encrypt].
|
* Multiple/virtual domains, with per-domain users and aliases.
|
||||||
* [SPF] checking.
|
* Suffix dropping (`user+something@domain` → `user@domain`).
|
||||||
* Monitoring HTTP server, with exported variables and tracing to help
|
* Hooks for integration with greylisting, anti-virus, anti-spam, and
|
||||||
debugging.
|
DKIM/DMARC.
|
||||||
* Supports using [Dovecot] for authentication (experimental).
|
* International usernames ([SMTPUTF8]) and domain names ([IDNA]).
|
||||||
|
* Secure
|
||||||
|
* Tracking of per-domain TLS support, prevents connection downgrading.
|
||||||
|
* Multiple TLS certificates.
|
||||||
|
* Easy integration with [Let's Encrypt].
|
||||||
|
* [SPF] checking.
|
||||||
|
|
||||||
The following are intentionally *not* implemented:
|
|
||||||
|
|
||||||
* Custom email routing.
|
|
||||||
* [DKIM]/[DMARC] checking (although the post-data hook can be used for it).
|
|
||||||
|
|
||||||
[SMTPUTF8]: https://en.wikipedia.org/wiki/Extended_SMTP#SMTPUTF8
|
[SMTPUTF8]: https://en.wikipedia.org/wiki/Extended_SMTP#SMTPUTF8
|
||||||
[IDNA]: https://en.wikipedia.org/wiki/Internationalized_domain_name
|
[IDNA]: https://en.wikipedia.org/wiki/Internationalized_domain_name
|
||||||
[Let's Encrypt]: https://letsencrypt.org
|
[Let's Encrypt]: https://letsencrypt.org
|
||||||
[Dovecot]: https://dovecot.org
|
[Dovecot]: https://dovecot.org
|
||||||
[SPF]: https://en.wikipedia.org/wiki/Sender_Policy_Framework
|
[SPF]: https://en.wikipedia.org/wiki/Sender_Policy_Framework
|
||||||
[DKIM]: https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail
|
[Debian]: https://debian.org
|
||||||
[DMARC]: https://en.wikipedia.org/wiki/DMARC
|
[Ubuntu]: https://ubuntu.com
|
||||||
|
|
||||||
|
|
||||||
## Status
|
## Status
|
||||||
@@ -61,17 +61,20 @@ which are also documented in the [UPGRADING](UPGRADING.md) file.
|
|||||||
|
|
||||||
## Documentation
|
## Documentation
|
||||||
|
|
||||||
Check out the [how-to](docs/howto.md) or the [installation guide](INSTALL.md)
|
The [Debian+Dovecot+chasquid how-to](docs/howto.md) and the
|
||||||
for more details on how to install and configure chasquid.
|
[installation guide](INSTALL.md)
|
||||||
|
are the best starting points on how to install, configure and run chasquid.
|
||||||
|
|
||||||
|
|
||||||
## Contact
|
## Contact
|
||||||
|
|
||||||
If you have any questions, comments or patches please send them to the mailing
|
If you have any questions, comments or patches please send them to the [mailing
|
||||||
list, chasquid@googlegroups.com.
|
list](https://groups.google.com/forum/#!forum/chasquid),
|
||||||
|
chasquid@googlegroups.com.
|
||||||
|
|
||||||
To subscribe, send an email to chasquid+subscribe@googlegroups.com.
|
To subscribe, send an email to chasquid+subscribe@googlegroups.com.
|
||||||
|
|
||||||
You can also browse the
|
You can also reach out via IRC, `#chasquid` on
|
||||||
[archives](https://groups.google.com/forum/#!forum/chasquid).
|
[freenode](https://freenode.net/).
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user