Metadata-Version: 2.4
Name: ess-pro-migration-tool
Version: 0.4.0
Author: Element Creations Ltd
Author-email: Element Creations Ltd <contact@element.io>
License-Expression: LicenseRef-Element-Commercial
Requires-Dist: certifi>=2026.4.0
Requires-Dist: cryptography>=48.0.0
Requires-Dist: idna>=3.0.0
Requires-Dist: jsonschema>=4.26.0
Requires-Dist: lightkube>=0.16.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: rapidfuzz>=3.14.3
Requires-Dist: rich>=13.0.0
Requires-Python: >=3.11.7, <4.0
Description-Content-Type: text/markdown

<!--
Copyright 2026 Element Creations Ltd

SPDX-License-Identifier: LicenseRef-Element-Commercial
-->

# ESS Pro Migration Tool

The ESS Pro Migration Tool helps you migrate your existing Synapse and Matrix Authentication Service (MAS) configurations to Element Server Suite Pro (ESS Pro) Helm values format. This tool automates the conversion process, making it easier to transition to ESS while preserving your existing configuration settings.

<!-- cSpell:disable -->
<p align="center">
<picture>
  <source srcset="./assets/ess-migration-tool.gif">
  <img alt="ESS Pro Migration Tool" width="680">
</picture>
</p>
<!-- cSpell:enable -->

## Installation

Install the migration tool, ideally using pipx:

```bash
pipx install ess-pro-migration-tool
```
or by using uv:
```bash
uv tool install ess-migration-tool
```

## Documentation

For more information on the tool and its usage, please refer to the [documentation](https://docs.element.io/latest/element-server-suite-pro/introduction-to-ess-pro/migration).