General Documentation

Welcome to the general documentation for the Madmail server.

Introduction to Madmail

Madmail is a powerful email application built on top of the Maddy project. It runs as a single Go (Golang) binary and its main goal is to create a secure and fast communication platform.

DeltaChat Messenger Integration

The most important feature of Madmail is that it creates an End-to-End Encrypted chat server for you. You can use this service with the popular DeltaChat application and enjoy a modern messenger experience on a completely private and decentralized platform.

Simple and Instant Registration (JIT)

One of the smart features of Madmail is support for instant registration, or Just-In-Time Registration. This means you don't need to go through lengthy registration steps; upon the first login attempt with new credentials, your account is automatically created if this feature is enabled. You can also use the registration button on the main page to quickly get a QR Code with your settings.

Voice and Video Calls (TURN)

One of the standout features of this server is having a dedicated TURN service to improve call quality in DeltaChat. This service acts as a relay so that if two users cannot connect directly (P2P), the call is routed through the server with high stability.

Storage Quota

To ensure fair resource distribution, the server enforces storage limits. You can view your usage and quota through any email client that supports the QUOTA extension.

Server Management (Admin API)

Since version v0.15.3, a control API (Admin API) is embedded within the server that allows easy server management. The Admin API path and the admin token are configurable and can be set statically in the server configuration file.

To get the default token for authentication, run the command maddy admin-token on your server.

In addition to this API, the Web Admin project has been developed for graphical server management. The source code is available at github.com/themadorg/madmail-admin-web and is automatically built and deployed at https://admin.madmail.chat/. Visit this link and enter your server address and token to easily manage your server.

Security Recommendations

Message Security: This service is very secure by default. To ensure communication privacy in DeltaChat, note that the presence of a grey icon next to messages means encryption is disabled; therefore, sensitive messages should not have this indicator.

Updates: To maintain security and benefit from the latest features, always keep your DeltaChat application updated to the latest version.

Support

For support, please contact your server administrator.