docker-mailserver/docs/content/setup-docker-mailserver-using-the-script-setup.sh.md

81 lines
2.5 KiB
Markdown

[`setup.sh`](https://github.com/docker-mailserver/docker-mailserver/blob/master/setup.sh) is an administration script that helps with the most common tasks, including initial configuration. It is intented to be used from the host machine, _not_ from within your running container.
The latest version of the script is included in the `docker-mailserver` repository. You may retrieve it at any time by running this command in your console:
``` BASH
wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/master/setup.sh
chmod a+x ./setup.sh
```
## Usage
Run `./setup.sh -h` and you'll get some usage information:
``` BASH
setup.sh Bootstrapping Script
Usage: ./setup.sh [-i IMAGE_NAME] [-c CONTAINER_NAME] <subcommand> <subcommand> [args]
OPTIONS:
-i IMAGE_NAME The name of the docker-mailserver image
The default value is
'docker.io/mailserver/docker-maiserver:latest'
-c CONTAINER_NAME The name of the running container.
-p PATH Config folder path (default: /home/georg/github/docker-mailserver/config)
-h Show this help dialogue
-z Allow container access to the bind mount content
that is shared among multiple containers
on a SELinux-enabled host.
-Z Allow container access to the bind mount content
that is private and unshared with other containers
on a SELinux-enabled host.
SUBCOMMANDS:
email:
./setup.sh email add <email> [<password>]
./setup.sh email update <email> [<password>]
./setup.sh email del <email>
./setup.sh email restrict <add|del|list> <send|receive> [<email>]
./setup.sh email list
alias:
./setup.sh alias add <email> <recipient>
./setup.sh alias del <email> <recipient>
./setup.sh alias list
quota:
./setup.sh quota set <email> [<quota>]
./setup.sh quota del <email>
config:
./setup.sh config dkim <keysize> (default: 2048) <domain.tld> (optional - for LDAP setups)
./setup.sh config ssl <fqdn>
relay:
./setup.sh relay add-domain <domain> <host> [<port>]
./setup.sh relay add-auth <domain> <username> [<password>]
./setup.sh relay exclude-domain <domain>
debug:
./setup.sh debug fetchmail
./setup.sh debug fail2ban [<unban> <ip-address>]
./setup.sh debug show-mail-logs
./setup.sh debug inspect
./setup.sh debug login <commands>
help: Show this help dialogue
```