Updated Setup docker mailserver using the script setup.sh (markdown)
This commit is contained in:
Georg Lauterbach
parent
41508c01f9
commit
a669ef9c62
|
|
@ -1,4 +1,4 @@
|
|||
[`setup.sh`](https://github.com/tomav/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.
|
||||
[`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:
|
||||
|
||||
|
|
@ -8,24 +8,32 @@ wget -q -O setup.sh https://raw.githubusercontent.com/tomav/docker-mailserver/ma
|
|||
|
||||
Or if you use curl:
|
||||
|
||||
```sh
|
||||
curl -o setup.sh https://raw.githubusercontent.com/tomav/docker-mailserver/master/setup.sh; chmod a+x ./setup.sh
|
||||
``` BASH
|
||||
wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/master/setup.sh
|
||||
chmod a+x ./setup.sh
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
Run `./setup.sh` without arguments and you'll get some usage information:
|
||||
Run `./setup.sh -h` and you'll get some usage information:
|
||||
|
||||
``` BASH
|
||||
setup.sh Bootstrapping Script
|
||||
|
||||
```sh
|
||||
Usage: ./setup.sh [-i IMAGE_NAME] [-c CONTAINER_NAME] <subcommand> <subcommand> [args]
|
||||
|
||||
OPTIONS:
|
||||
|
||||
-i IMAGE_NAME The name of the docker-mailserver image, by default
|
||||
'tvial/docker-mailserver:latest'.
|
||||
-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.
|
||||
|
|
@ -38,8 +46,8 @@ SUBCOMMANDS:
|
|||
|
||||
email:
|
||||
|
||||
./setup.sh email add <email> <password>
|
||||
./setup.sh email update <email> <password>
|
||||
./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
|
||||
|
|
@ -56,44 +64,23 @@ SUBCOMMANDS:
|
|||
config:
|
||||
|
||||
./setup.sh config dkim <keysize> (default: 2048)
|
||||
./setup.sh config ssl
|
||||
./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
|
||||
|
||||
|
||||
```
|
||||
|
||||
## email
|
||||
|
||||
* `./setup.sh email add <email> [<password>]`: Add an email-account (\<password\> is optional)
|
||||
* `./setup.sh email update <email> [<password>]`: Change the password of an email-account (\<password\> is optional)
|
||||
* `./setup.sh email del <email>`: delete an email-account
|
||||
* `./setup.sh email restrict <add|del|list> <send|receive> [<email>]`: deny users to send or receive mail. You can also list the respective denied mail-accounts.
|
||||
* `./setup.sh email list`: list all existing email-accounts
|
||||
|
||||
## alias
|
||||
* `./setup.sh alias add <email> <recipient>`: add an alias(email) for an email-account(recipient)
|
||||
* `./setup.sh alias del <email> <recipient>`: delete an alias
|
||||
* `./setup.sh alias list`: list all aliases
|
||||
|
||||
## quota
|
||||
|
||||
* `./setup.sh quota set <email> [<quota>]`: define the quota of a mailbox (quota format e.g. 302M (B (byte), k (kilobyte), M (megabyte), G (gigabyte) or T (terabyte)))
|
||||
* `./setup.sh quota del <email>`: delete the quota of a mailbox
|
||||
|
||||
## config
|
||||
|
||||
* `./setup.sh config dkim <keysize> (default: 2048)`: autoconfig the dkim-config with an (optional) keysize value
|
||||
* `./setup.sh config ssl`: generate ssl-certificates
|
||||
|
||||
## debug
|
||||
|
||||
* `./setup.sh debug fetchmail`: see [wiki](https://github.com/tomav/docker-mailserver/wiki/Retrieve-emails-from-a-remote-mail-server-%28using-builtin-fetchmail%29#debugging)
|
||||
* `./setup.sh debug fail2ban <unban> <ip-address>`: omitt all options to get a list of banned IPs, otherwise unban the specified IP.
|
||||
* `./setup.sh debug show-mail-logs`: show the logfile contents of the mail container
|
||||
* `./setup.sh debug inspect`: show infos about the running container
|
||||
* `./setup.sh debug login <commands>`: run a command inside the mail container (omit the command to get shell access)
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue