From Mailix 1.2.5. Mailix 1.2.4 and earlier have no licence activation.
One Mailix licence covers one server: every cPanel account and every mailbox on it. The licence runs for a year and has a 7-day grace period after it ends. You activate it once, as root, and the server then checks it by itself.
Mail never depends on the licence. If the licence is not active, users keep reading and sending mail, and archives, import, filters and automatic replies keep working. Only the AI features pause.
Before you start
- Install or update Mailix to version 1.2.5 or later with
bash cpanel/install.sh. See Install Mailix on a cPanel and WHM server. - Check the server's host name in WHM » Networking Setup » Change Hostname. It must be a full name, for example
server.example.com. The licence is bound to this name. - Have root SSH access to the server.
Get the activation code
- Open your Mailix licence e-mail from ARN Smart.
- Click the link to request the activation code.
- The code arrives in a separate e-mail to the licence's address. It starts with
ARNA-, is valid for 48 hours and works for one activation.
Request the code when you are ready to activate. If it expires, request a new one with the same link.
Activate the licence
Run as root:
/usr/local/cpanel/base/3rdparty/mailix/bin/mailix-licence activate
Paste the activation code when the command asks for it; it is not shown while you paste. The command ends with Mailix is activated for and your server's host name, followed by the licence end date.
Note: Do not add the code to the command line. Other users of the server could see it in the process list while the command runs; the command warns you if you do.
If the command stops with a message, the server is not activated. The most common messages:
| Message | What to do |
|---|---|
| The activation code is not valid or was already used | Request a new code with the link in your licence e-mail. |
| The activation code has expired | Request a new code; a code is valid for 48 hours. |
| The licence is bound to another host name | Release it on the old server with mailix-licence deactivate, or contact ARN Smart support. |
| This server has no fully qualified host name | Set a full host name in WHM, then activate again. |
| PHP has no sodium extension | Run the command with a PHP 8.1 or newer that has it, for example MAILIX_PHP=/opt/cpanel/ea-php84/root/usr/bin/php. |
Check the licence
/usr/local/cpanel/base/3rdparty/mailix/bin/mailix-licence status
The command shows the licence state with its date, the licence ID, the host name and the time of the last check. Include the licence ID, never the activation code, when you contact support.
The server checks the licence four times a day with a cron job (/etc/cron.d/mailix-licence, added by the installation script). The job writes nothing while the state stays the same. Cron e-mails a short message to root once 14 days before the licence ends, and whenever the state changes, for example when the grace period starts. To check at once, run mailix-licence refresh.
If the licence server cannot be reached, AI features keep working for up to 7 days after the last successful check. If the licence server refuses the licence, AI features pause at once.
The cPanel account owner and the company's AI managers see the licence state in Mailix under Settings → Mailix → About, in the Server licence row. Mail users do not see licence details.
What happens when
| Situation | AI features | |
|---|---|---|
| The licence is active | Works | Work |
| A new server that is not activated yet, first 14 days after installation | Works | Work |
| Not activated 14 days after installation | Works | Paused |
| The licence ended, during the 7-day grace period | Works | Work |
| The licence and its grace period ended | Works | Paused |
| The licence server cannot be reached, up to 7 days after the last successful check | Works | Work |
| The licence was not checked for more than 7 days | Works | Paused |
| The licence was suspended or moved, or the host name changed | Works | Paused |
When AI features are paused, mail users see a short note in Settings → AI assistant, and an automatic reply set to Reply with AI sends its fixed text instead. AI features come back by themselves after the next successful check, for example after the licence is renewed. To check at once after a renewal, run mailix-licence refresh.
New Mailix versions are delivered to active licences only.
Move the licence to another server
- On the old server, run
mailix-licence deactivateas root. It releases the licence on the ARN licence server (three times in 30 days at most) and shows the link for a fresh activation code. When the licence server refuses or cannot be reached, nothing changes;--localremoves the activation from this server only. - On the new server, request a new activation code with that link and activate.
If the old server is no longer available, ARN Smart support can release the licence for you.
Changing the host name of the server needs the same steps.
Where the licence is stored
/etc/mailix/licence.jsonkeeps the licence key and the server's secret. Only root can read it. Keep it in your server backups.config/licence.jsonin the Mailix folder holds the signed result of the last check, without any secret. Mailix reads it; it never contacts the licence server itself.
Updating Mailix keeps both files. Removing Mailix with bash cpanel/uninstall.sh removes the cron job and keeps /etc/mailix, so a new installation on the same server uses the licence again.