diff --git a/docs/compose/.env.dist b/docs/compose/.env similarity index 100% rename from docs/compose/.env.dist rename to docs/compose/.env diff --git a/docs/compose/docker-compose.yml.dist b/docs/compose/docker-compose.yml similarity index 91% rename from docs/compose/docker-compose.yml.dist rename to docs/compose/docker-compose.yml index c0291070..0900e5b5 100644 --- a/docs/compose/docker-compose.yml.dist +++ b/docs/compose/docker-compose.yml @@ -3,7 +3,6 @@ version: '2' services: front: - # build: nginx image: mailu/nginx:$VERSION restart: always env_file: .env @@ -36,7 +35,6 @@ services: - "$ROOT/redis:/data" imap: - # build: dovecot image: mailu/dovecot:$VERSION restart: always env_file: .env @@ -46,7 +44,6 @@ services: - "$ROOT/overrides:/overrides" smtp: - # build: postfix image: mailu/postfix:$VERSION restart: always env_file: .env @@ -55,7 +52,6 @@ services: - "$ROOT/overrides:/overrides" antispam: - # build: rspamd image: mailu/rspamd:$VERSION restart: always env_file: .env @@ -64,7 +60,6 @@ services: - "$ROOT/overrides/rspamd:/etc/rspamd/override.d" antivirus: - # build: clamav image: mailu/$ANTIVIRUS:$VERSION restart: always env_file: .env @@ -72,7 +67,6 @@ services: - "$ROOT/filter:/data" webdav: - # build: $WEBDAV image: mailu/$WEBDAV:$VERSION restart: always env_file: .env @@ -80,7 +74,6 @@ services: - "$ROOT/dav:/data" admin: - # build: admin image: mailu/admin:$VERSION restart: always env_file: .env @@ -90,7 +83,6 @@ services: - /var/run/docker.sock:/var/run/docker.sock:ro webmail: - # build: "$WEBMAIL" image: "mailu/$WEBMAIL:$VERSION" restart: always env_file: .env @@ -98,7 +90,6 @@ services: - "$ROOT/webmail:/data" fetchmail: - # build: fetchmail image: mailu/fetchmail:$VERSION restart: always env_file: .env diff --git a/docs/compose/setup.rst b/docs/compose/setup.rst index c5ed4529..263ebe51 100644 --- a/docs/compose/setup.rst +++ b/docs/compose/setup.rst @@ -15,21 +15,16 @@ Mailu will store all of its persistent data in a path of your choice Download the initial configuration file --------------------------------------- -Docker Compose configuration is stored in a file named ``docker-compose.yml``. -Additionally, Mailu relies on an environment file for various settings. -Download the proper template files from the git repository. For `stable`: +Docker Compose configuration is stored in a file named +:download:`docker-compose.yml`. Additionally, Mailu +relies on a :download:`.env` file for various settings. Download +the proper template files from the git repository. To download the configuration +for the "|version|" branch, use: -.. code-block:: bash +.. parsed-literal:: - wget -O docker-compose.yml https://raw.githubusercontent.com/Mailu/Mailu/stable/docs/compose/docker-compose.yml.dist - wget -O .env https://raw.githubusercontent.com/Mailu/Mailu/stable/docs/compose/.env.dist - -For the latest version (replace with version number otherwise): - -.. code-block:: bash - - wget -O docker-compose.yml https://raw.githubusercontent.com/Mailu/Mailu/master/docs/compose/docker-compose.yml.dist - wget -O .env https://raw.githubusercontent.com/Mailu/Mailu/master/docs/compose/.env.dist + wget https://mailu.io/|version|/_downloads/docker-compose.yml + wget https://mailu.io/|version|/_downloads/.env Then open the ``.env`` file to setup the mail server. Modify the ``ROOT`` setting to match your setup directory if different from ``/mailu``. @@ -50,11 +45,11 @@ you would simply like the server to listen on all interfaces, use ``0.0.0.0``. Modify ``BIND_ADDRESS6`` to match the public IPv6 address assigned to your server. The behavior is identical to ``BIND_ADDRESS4``. -Set the `TLS_FLAVOR` to one of the following +Set the ``TLS_FLAVOR`` to one of the following values: -- `cert` is the default and requires certificates to be setup manually; -- `letsencrypt` will use the Letsencrypt! CA to generate automatic ceriticates; -- `notls` will disable TLS, this is not recommended except for testing. +- ``cert`` is the default and requires certificates to be setup manually; +- ``letsencrypt`` will use the Letsencrypt! CA to generate automatic ceriticates; +- ``notls`` will disable TLS, this is not recommended except for testing. Enable optional features ------------------------