linagora/tmail-web repository overview

⁠TMail web app

The web app for TMail client in a docker container.

⁠Standalone docker container

To run it, you need to create a environment file, like env.dev.file and fill the SERVER_URL parameter of your JMAP backend server url in it, so the web application can connect to it:

SERVER_URL=https://my-jmap-server.com

Then just run your docker container by mounting the environment file like this:

  docker run -d -ti -p 8080:80 --mount type=bind,source="$(pwd)"/env.dev.file,target=/usr/share/nginx/html/assets/env.file --name web linagora/tmail-web:master

Then go to http://localhost:8080⁠ and you should be able to login against your JMAP backend using the TMail web-app.

⁠Using the docker-compose file

We also include a docker-compose.yaml⁠ file so you can get a testing environment up quickly. This uses our tmail-backend⁠ image for the JMAP server.

First, get the docker-compose file⁠. Then follow the steps:

1. Generate JWT keys for tmail-backend:

openssl genpkey -algorithm rsa -pkeyopt rsa_keygen_bits:4096 -out jwt_privatekey
openssl rsa -in jwt_privatekey -pubout -out jwt_publickey

1. Create an env.file with the following content:

SERVER_URL=http://localhost/

1. Run docker compose up -d to bring up both the frontend and the backend.
2. Run docker compose exec tmail-backend /root/provisioning/provisioning.sh to provision some demo accounts (you don't have to let it run all the way).
3. The TMail web-app should be available at http://localhost:8080. The credentials for demo accounts are:

User: alice@localhost
Password: aliceSecret

User: bob@localhost
Password: bobSecret

User: empty@localhost
Password: emptrySecret