# Halon MSUI

> Halon MSUI 1.21-stable documentation

## Pages

- [MSUI manual](index.html.md): Managed Service User Interface (MSUI) is an add-on component to Halon.
- [Installation](install.html.md): Halon MSUI is provided in our package mirror for Ubuntu and RHEL (CentOS) distributions.
- [Configuration](config.html.md): The MSUI configuration is done through files in YAML format:
- [History logging](history.html.md): The history logging configuration controls the integration with Elasticsearch and the MTA, this enables users to for example release messages from quarantine and interact with the Halon queue directly.
- [Configuration export](export.html.md): For persistent processing and routing of email, the configuration export function can export all domains, users, and settings from MSUI to a single YAML file (msui-config.yaml).
- [Web administration](administration.html.md): In addition to the settings that come pre-packaged with MSUI it is also possible to add custom settings, these can vary from simple toggle buttons (true/false) to lists and text, depending on the use-case.
- [Permissions](permissions.html.md): If using the default sql file from the Initial setup, MSUI will come with a few pre-defined roles but it is also possible to create custom roles with different permissions depending on your needs.
- [Integration](integration.html.md): MSUI offers a lot of options for integrating with Halon which in combination with the Halon Scripting Language (HSL) provides a high degree of flexibility.
- [API](api.html.md): MSUI includes an extensive API that you can use to integrate MSUI with other systems such as Halon to manage domains, users, and its settings.
- [Changelog](changelog.html.md): Released 2026-11-11

## Optional

- [llms-full.txt](llms-full.txt): Complete documentation in a single file.