ARN Smart Support
Language: English

Update or remove Mailix

Updated 19 Nov 2026 4 min read
Browse Mailix articles

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

WhatWhereWhy
Configurationconfig/config.phpYour server options
Mailix data (server-wide)Each cPanel account's ~/.mailixSettings, contacts kept in Mailix, two-step verification, company AI account
Mailix data (standalone)The storage_dir folderThe same data for all mailboxes
Licence (server-wide, from 1.2.5)/etc/mailix/licence.jsonThe server's licence activation

Important: Keep the file 2fa-secret.key in the storage root together with the mailboxes' 2fa.json files 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 ~/.mailix data 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/mailix is 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.

On this page

Submit a ticket

Create a new support request without needing a portal account.

Priority
Attachments
Only you and our staff see a ticket. Never send passwords or licence codes.

Track a ticket

Use the ticket number and password from your confirmation email.

The number and the password are in your confirmation email.

Sign in

Access your support portal account.

New here?

Create account

Create your support portal account.

Already have an account?

Forgot password?

We email you a link to choose a new password.

Conversation

Was this helpful?
Open full article
↑ ↓ to moveEnter to openEsc to close