=head1 NAME
chasquid - SMTP (email) server
=head1 SYNOPSIS
B<chasquid> [I<options>...]
=head1 DESCRIPTION
chasquid is an SMTP (email) server with a focus on simplicity, security, and
ease of operation.
It's written in Go, and distributed under the Apache license 2.0.
=head1 OPTIONS
=over 8
=item B<-config_dir> I<dir>
configuration directory (default F</etc/chasquid>)
=item B<-config_overrides> I<config>
configuration values (in text protobuf format) to override the on-disk
configuration with. This should only be needed in very specific cases for
deployments where editing the configuration file is not feasible.
=item B<-alsologtostderr>
also log to stderr, in addition to the file
=item B<-logfile> I<file>
file to log to (enables logtime)
=item B<-logtime>
include the time when writing the log to stderr
=item B<-logtosyslog> I<tag>
log to syslog, with the given tag
=item B<-v> I<level>
verbosity level (1 = debug)
=item B<-version>
show version and exit
=back
=head1 FILES
The daemon's configuration is by default in F</etc/chasquid/>, and can be
changed with the I<-config_dir> flag.
Inside that directory, the daemon expects the following structure:
=over 8
=item F<chasquid.conf>
Main config file, see chasquid.conf(5).
=item F<domains/>
Per-domain configuration.
=item F<domains/example.com/>
Domain-specific configuration. Can be empty.
=item F<domains/example.com/users>
User and password database for this domain.
=item F<domains/example.com/aliases>
Aliases for the domain.
=item F<certs/>
Certificates to use, one directory per pair.
=item F<certs/mx.example.com/>
Certificates for this domain.
=item F<certs/mx.example.com/fullchain.pem>
Certificate (full chain).
=item F<certs/mx.example.com/privkey.pem>
Private key.
=back
Note the F<certs/> directory layout matches the one from certbot (client for
Let's Encrypt CA), so you can just symlink F<certs/> to
F</etc/letsencrypt/live>.
Make sure the user you use to run chasquid under ("mail" in the example
config) can access the certificates and private keys.
=head1 CONTACT
L<Main website|https://blitiri.com.ar/p/chasquid>.
If you have any questions, comments or patches please send them to the mailing
list, C<chasquid@googlegroups.com>. To subscribe, send an email to
C<chasquid+subscribe@googlegroups.com>.
=head1 SEE ALSO
chasquid-util(1), chasquid.conf(5)