ARN Smart Support
Language: English

Activate and check the Mailix server licence

Updated 12 Nov 2026 5 min read
Browse Mailix articles

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

  1. Open your Mailix licence e-mail from ARN Smart.
  2. Click the link to request the activation code.
  3. 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:

MessageWhat to do
The activation code is not valid or was already usedRequest a new code with the link in your licence e-mail.
The activation code has expiredRequest a new code; a code is valid for 48 hours.
The licence is bound to another host nameRelease it on the old server with mailix-licence deactivate, or contact ARN Smart support.
This server has no fully qualified host nameSet a full host name in WHM, then activate again.
PHP has no sodium extensionRun 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

SituationMailAI features
The licence is activeWorksWork
A new server that is not activated yet, first 14 days after installationWorksWork
Not activated 14 days after installationWorksPaused
The licence ended, during the 7-day grace periodWorksWork
The licence and its grace period endedWorksPaused
The licence server cannot be reached, up to 7 days after the last successful checkWorksWork
The licence was not checked for more than 7 daysWorksPaused
The licence was suspended or moved, or the host name changedWorksPaused

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

  1. On the old server, run mailix-licence deactivate as 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; --local removes the activation from this server only.
  2. 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.json keeps the licence key and the server's secret. Only root can read it. Keep it in your server backups.
  • config/licence.json in 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.

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