mirror of
https://github.com/Mailu/Mailu.git
synced 2025-06-02 23:17:26 +02:00
Fix documentation INITIAL_ADMIN_* variables
This commit is contained in:
parent
18865bf03b
commit
83d9a81f0f
@ -99,8 +99,7 @@ You may now start Mailu. Move the to the Mailu directory and run:
|
||||
Finally, you need an admin user account.
|
||||
|
||||
You can have the system create it automatically:
|
||||
use the environment variables ``INITIAL_ACCOUNT*`` as described in :ref:`admin_account`
|
||||
You should set ``INITIAL_ADMIN_MODE`` also to either ``update`` or ``ifmissing``. Leaving it with the default value could cause errors when restarting the system.
|
||||
use the environment variables ``INITIAL_ADMIN_*`` as described in :ref:`admin_account`
|
||||
|
||||
Else, if you don't go with the automatic way, you need to manually create the admin account now:
|
||||
|
||||
|
@ -159,18 +159,25 @@ To create it manually, follow the specific deployment method documentation.
|
||||
|
||||
To have the account created automatically, you just need to define a few environment variables:
|
||||
|
||||
- ``INITIAL_ADMIN_ACCOUNT``: the admin username: The first part of the e-mail address before the @.
|
||||
- ``INITIAL_ADMIN_DOMAIN``: the domain appendix: Most probably identical to the ``DOMAIN`` variable.
|
||||
- ``INITIAL_ADMIN_PW``: the admin password.
|
||||
- ``INITIAL_ADMIN_MODE``: one of the options below how the code should behave when it will try to create the admin user:
|
||||
|
||||
- ``create``: (default) Will try to create user and will raise an exception if present.
|
||||
- ``ifmissing``: if user exists, nothing happens, else it will be created.
|
||||
- ``update``: user is created or, if it exists, its password gets updated.
|
||||
|
||||
You should set ``INITIAL_ADMIN_MODE`` also to either ``update`` or ``ifmissing``. Leaving it with the default value could cause errors when restarting the system.
|
||||
|
||||
An example:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
INITIAL_ADMIN_ACCOUNT = ``root`` The first part of the e-mail address (ROOT@example.com)
|
||||
INITIAL_ADMIN_DOMAIN = ``example.com`` the domain appendix. Most probably identical to the DOMAIN variable
|
||||
INITIAL_ADMIN_PW = ``password`` the chosen password for the user
|
||||
|
||||
Also, environment variable ``INITIAL_ADMIN_MODE`` defines how the code should behave when it will
|
||||
try to create the admin user:
|
||||
|
||||
- ``create`` (default) Will try to create user and will raise an exception if present
|
||||
- ``ifmissing``: if user exists, nothing happens, else it will be created
|
||||
- ``update``: user is created or, if it exists, its password gets updated
|
||||
INITIAL_ADMIN_ACCOUNT=me
|
||||
INITIAL_ADMIN_DOMAIN=example.net
|
||||
INITIAL_ADMIN_PW=password
|
||||
INITIAL_ADMIN_MODE=ifmissing
|
||||
|
||||
Depending on your particular deployment you most probably will want to change the default.
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user