EML Docs

Install EML AdminTool (dev)

This page explains how to run EML AdminTool locally for development and testing. No NGINX, SSL certificate, or domain name is required.

Warning

This setup is intended for development only. Do not expose a local EML AdminTool instance to the internet without completing the production setup steps.

Download the Compose file

Go to the EML AdminTool releases page and download the docker-compose.prod.yml file from the assets of the version you want to install.

Store it in a dedicated, permanent directory — EML AdminTool needs this file to start. A good default location:

Do not move or delete this file. EML AdminTool depends on it for subsequent starts and updates.

Start EML AdminTool

Open a terminal, navigate to the directory containing the file, and run:

docker compose -f docker-compose.prod.yml up -d

EML AdminTool is now available at http://localhost:8080/.

Initial setup wizard

Open http://localhost:8080/ in a browser. You will be redirected to the setup wizard automatically. Follow the same steps as for a production installation:

  1. Language — Select the interface language.
  2. Database password — Use the “Generate” button to create a strong password.
  3. Admin account — Create the administrator account with your server name as the username.

After clicking “Finish”, EML AdminTool restarts and you are redirected to the login page.

Stop and restart

To stop EML AdminTool:

docker compose -f docker-compose.prod.yml down

To start it again:

docker compose -f docker-compose.prod.yml up -d

Note

Your data (users, files, settings) is persisted in a Docker volume and survives container restarts. It is only lost if you explicitly delete the volume with docker volume prune or equivalent.