• June 20, 2025
• 2 min read

Upgrading Self Hosted Stalwart Mail Experience

Steps

1. Get the current version of Stalwart Mail.

   • current version: v0.8.0

2. Check the documentation for the latest version.

   • upgrading documentation: https://github.com/stalwartlabs/stalwart/blob/main/UPGRADING.md

3. Upgrade to the next major version incrementally

   • next major version: v0.9.x
   • next major version: v0.10.x
   • next major version: v0.11.x
   • next major version: v0.12.x

4. Fix issues that arise during the upgrade process.

   • issue: failed to start when using v0.11.0

     root causes:

     • https://github.com/stalwartlabs/stalwart/issues/1057
     • https://github.com/stalwartlabs/stalwart/issues/1104

     resolution: use v0.11.3 when upgrading from v0.10 to v0.11

   • issue: cannot login to web admin after upgrading it to latest version when using the old version of stalwart mail

     root causes:

     • https://www.reddit.com/r/stalwartlabs/comments/1ikfz8u/error_trying_to_log_in_admin/

     resolution: finish the upgrade to the latest version v0.12.4

5. Export and backup the data before upgrading.

   • export and backup data using stalwart mail CLI command
   • backup the database data using the database management tool