Mailix updates come as an update package, mailix-update-<version>.zip. It has the same content as the installation package of that version. Updates replace the application files and keep the configuration file and all user data.
When a new version is available
The licence cron job asks ARN whether a newer Mailix is published (active licences only). A new version shows in Settings → Mailix → About for the cPanel account owner and the company's AI managers: Update available, the version, the release notes and, when ARN Smart marks it so, Important update. Root gets one cron e-mail per new version. Mailix never installs an update by itself.
Update with mailix-update
As root, run:
/usr/local/cpanel/base/3rdparty/mailix/bin/mailix-update check
/usr/local/cpanel/base/3rdparty/mailix/bin/mailix-update install
install asks before it starts; --yes skips the question. The command downloads the package only from ARN over HTTPS, checks its size, its SHA-256, the signed answer and ARN Smart's release signature, keeps the running version and config.php in /root/mailix-releases/, and runs the new version's installation script. If that fails, the previous version is installed again. From Mailix 1.2.9 the installation script keeps running when the SSH connection drops; its output is written to a log file in /root/mailix-releases/ and shown when it ends. If the download link expired while you read the release notes, the command asks ARN once more for the same version.
Before you update by hand
- Back up the configuration file and the Mailix data (see "What to back up" below).
- Have the update package of the new version from ARN Smart.
Update a server-wide installation by hand
Unpack the update package into a new, empty folder and run the installation script again as root:
mkdir -p /root/mailix-1.2.9
unzip mailix-update-1.2.9.zip -d /root/mailix-1.2.9
cd /root/mailix-1.2.9
bash cpanel/install.sh
Run the script only from the folder you unpacked the package into, never from the installed copy in /usr/local/cpanel/base/3rdparty/mailix. From Mailix 1.2.9 it stops without changing anything in both cases it cannot handle safely: a folder that holds other files, or the installed copy.
The script replaces the whole application, so files that the new version no longer has do not stay behind. config/config.php is kept, and from Mailix 1.2.5 the licence too. The app manifest and start page are published again, and the backup exclude line is added only if it is missing.
Users get the new version on their next page load. Mailix loads its scripts from versioned addresses, so browsers and cPanel's cache do not keep old files.
Update a standalone installation
Unpack the update package over the existing files. config/config.php and the storage folder are not part of the package and stay as they are.
After the update
Open Mailix and check Settings → Mailix → About. It shows Version with the new version number.
What to back up
| What | Where | Why |
|---|---|---|
| Configuration | config/config.php | Your server options |
| Mailix data (server-wide) | Each cPanel account's ~/.mailix | Settings, contacts kept in Mailix, two-step verification, company AI account |
| Mailix data (standalone) | The storage_dir folder | The same data for all mailboxes |
| Licence (server-wide, from 1.2.5) | /etc/mailix/licence.json | The server's licence activation |
Important: Keep the file
2fa-secret.keyin the storage root together with the mailboxes'2fa.jsonfiles in your backups. The key unlocks the two-step verification secrets. Without it, mailboxes with two-step verification can sign in only with a recovery code.
Prepared archives (~/.mailix/users/*/archive) are copies of the mailbox's own mail and are deleted after 72 hours, so they do not belong in backups. The installation script excludes them from cPanel's account backups; exclude them in other backup tools yourself.
Remove Mailix from a server
From the unpacked Mailix folder, run as root:
bash cpanel/uninstall.sh
The script removes Mailix from the server and from the cPanel Webmail screen, deletes the app manifest folder and takes Mailix's line out of cPanel's backup exclude list.
- Each account's
~/.mailixdata is kept. Delete it yourself if it is no longer needed. - Mailboxes that used the weekly automatic reply keep one line in the account's crontab, ending with
# Mailix weekly automatic reply. Without Mailix it only exits; you can delete it on cPanel's Cron Jobs page. - From Mailix 1.2.5: the licence cron job is removed and the licence in
/etc/mailixis kept, so a new installation on the same server uses it again. See Activate and check the Mailix server licence to move the licence to another server.
To remove a standalone installation, delete its folder and, if you no longer need it, the storage folder.