mailu/setup/flavors/compose/setup.html

{% import "macros.html" as macros %}

{% call macros.panel("info", "Step 1 - Download your configuration files") %}
<p>Docker Compose expects a project file, named <code>docker-compose.yml</code>
in a project directory. First create your project directory.</p>

<pre><code>mkdir {{ root }}
</pre></code>

<p>Then download the project file. A side configuration file makes it easier
to read and check the configuration variables generated by the wizard.</p>

<pre><code>cd {{ root }}
curl {{ url_for('.file', uid=uid, filepath='docker-compose.yml', _external=True) }} > docker-compose.yml
curl {{ url_for('.file', uid=uid, filepath='mailu.env', _external=True) }} > mailu.env
</pre></code>
{% endcall %}


{% call macros.panel("info", "Step 2 - Review the configuration") %}
<p>We did not insert any malicious code on purpose in the configurations we
distribute, but your download could have been intercepted, or our wizard
website could have been compromised, so make sure you check the configuration
files before going any further.</p>

<p>When you are done checking them, check them one last time.</p>
{% endcall %}

{% call macros.panel("info", "Step 3 - Start the Compose project") %}
<p>To start your compose project, simply run the Docker Compose <code>up</code>
command.</p>

<pre><code>cd {{ root }}
docker-compose up -d
</pre></code>

Before you can use Mailu, you must create the primary administrator user account. This should be {{ postmaster }}@{{ domain }}. Use the following command, changing PASSWORD to your liking:

<pre><code>docker-compose exec admin python manage.py admin {{ postmaster }} {{ domain }} PASSWORD
</pre></code>

Login the the admin interface to change the password for a safe one, at
{% if admin_enabled %}
one of the hostnames ({{ hostnames }}){{ admin_path }}.
{% else %}
http://127.0.0.1:8080 (only directly from the host running docker).
{% endif %}
And choose the "Update password" option in the left menu.
{% endcall %}