mirror of
https://github.com/docker-mailserver/docker-mailserver.git
synced 2024-01-19 02:48:50 +00:00
Updated Setup docker mailserver using the script setup.sh (markdown)
This commit is contained in:
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:
|
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:
|
Or if you use curl:
|
||||||
|
|
||||||
```sh
|
``` BASH
|
||||||
curl -o setup.sh https://raw.githubusercontent.com/tomav/docker-mailserver/master/setup.sh; chmod a+x ./setup.sh
|
wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/master/setup.sh
|
||||||
|
chmod a+x ./setup.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
## Usage
|
## 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]
|
Usage: ./setup.sh [-i IMAGE_NAME] [-c CONTAINER_NAME] <subcommand> <subcommand> [args]
|
||||||
|
|
||||||
OPTIONS:
|
OPTIONS:
|
||||||
|
|
||||||
-i IMAGE_NAME The name of the docker-mailserver image, by default
|
-i IMAGE_NAME The name of the docker-mailserver image
|
||||||
'tvial/docker-mailserver:latest'.
|
The default value is
|
||||||
|
'docker.io/mailserver/docker-maiserver:latest'
|
||||||
|
|
||||||
-c CONTAINER_NAME The name of the running container.
|
-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
|
-z Allow container access to the bind mount content
|
||||||
that is shared among multiple containers
|
that is shared among multiple containers
|
||||||
on a SELinux-enabled host.
|
on a SELinux-enabled host.
|
||||||
|
@ -38,8 +46,8 @@ SUBCOMMANDS:
|
||||||
|
|
||||||
email:
|
email:
|
||||||
|
|
||||||
./setup.sh email add <email> <password>
|
./setup.sh email add <email> [<password>]
|
||||||
./setup.sh email update <email> <password>
|
./setup.sh email update <email> [<password>]
|
||||||
./setup.sh email del <email>
|
./setup.sh email del <email>
|
||||||
./setup.sh email restrict <add|del|list> <send|receive> [<email>]
|
./setup.sh email restrict <add|del|list> <send|receive> [<email>]
|
||||||
./setup.sh email list
|
./setup.sh email list
|
||||||
|
@ -56,44 +64,23 @@ SUBCOMMANDS:
|
||||||
config:
|
config:
|
||||||
|
|
||||||
./setup.sh config dkim <keysize> (default: 2048)
|
./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:
|
debug:
|
||||||
|
|
||||||
./setup.sh debug fetchmail
|
./setup.sh debug fetchmail
|
||||||
|
./setup.sh debug fail2ban [<unban> <ip-address>]
|
||||||
./setup.sh debug show-mail-logs
|
./setup.sh debug show-mail-logs
|
||||||
./setup.sh debug inspect
|
./setup.sh debug inspect
|
||||||
./setup.sh debug login <commands>
|
./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 a new issue