ARN Smart Support
Language: English

Configure Mailix

Updated 19 Nov 2026 5 min read
Browse Mailix articles

All server options of Mailix are in one file, config/config.php. The sample file config/config.sample.php explains every option. Mail users change their own settings inside Mailix; this file is for the server administrator.

Mailix illustration of the configuration file and the demo mode

Where the file is

InstallationConfiguration file
Server-wide (WHM)/usr/local/cpanel/base/3rdparty/mailix/config/config.php
Standaloneconfig/config.php in the folder where you uploaded Mailix

Any option missing from config.php takes its value from the sample file, so you only need to keep the options you change. Changes apply to the next request; there is nothing to restart.

Warning: On a cPanel server every cPanel account can read config.php. Do not put API keys or passwords in it there.

Sending and receiving mail

Mailix reads mail over IMAP and sends it over authenticated SMTP, signing in with each mailbox's own address and password. On a cPanel server both services run on the same machine, and the defaults already point to them:

'imap' => ['host' => 'localhost', 'port' => 993, 'security' => 'ssl', 'verify_peer' => false],
'smtp' => ['host' => 'localhost', 'port' => 465, 'security' => 'ssl', 'verify_peer' => false],
  • security is ssl (IMAP 993, SMTP 465), starttls (IMAP 143, SMTP 587) or none. none makes the connection unencrypted.
  • verify_peer checks the server certificate. It is off by default because the certificate of localhost usually does not match its name on cPanel servers. Turn it on when you connect with the server's real host name.
  • timeout is the IMAP and SMTP connection timeout in seconds (20 by default).

Mailix has no sending domains or domain verification of its own. Messages leave through your server's SMTP service, so SPF, DKIM and DMARC for your domains are set up on the mail server, for example in cPanel.

Sign-in and sessions

OptionDefaultWhat it does
allowed_domainsEmpty (every domain)Only addresses of these domains can sign in
idle_minutes120Idle time before sign-out when Keep me signed in is not ticked
remember_days14How long Keep me signed in lasts
login_attempts8Failed sign-ins allowed per IP address
lockout_minutes15Period for counting failed sign-ins, and the wait after too many
cpanel_autologintrueAutomatic sign-in from cPanel Webmail
qr_sign_intrueSigning in new devices with a QR code (standalone only)

Interface and limits

OptionDefaultWhat it does
app_nameMailixName in the browser title, on the sign-in screen and in the installed app
default_languageenLanguage for new users: en, tr, ar or auto (follows the browser)
default_themeautoTheme for new users: auto, light or dark
upload_max_mb25Limit for one attachment and for all attachments of a message, in MB
feedback_addresssupport@arnsmart.comWhere Send feedback messages go; empty hides the button

After you change app_name on a server-wide installation, run the installation script again so that the installed app shows the new name. Run it from the package folder of the installed version, for example bash /root/mailix-releases/1.2.9/cpanel/install.sh after an update with mailix-update, never from the installed copy. A folder of an older version would install that older version again.

Send feedback messages go to ARN Smart by default. If you prefer that your users' notes reach your own support team, set feedback_address to your own address, or leave it empty to hide the button.

Server services

OptionDefaultWhat it does
cpanel_apiOn, localhost, port 2096cPanel API for server filters and automatic replies; set enabled to false on servers without cPanel
carddavOn, https://localhost:2080/Address book server; the address book is found automatically
storage_dirstorage/Sessions, settings, uploads and caches; cPanel Webmail uses each account's ~/.mailix instead

Archive

'archive' => ['enabled' => true, 'part_mb' => 1024, 'keep_hours' => 72],
  • enabled turns the Archive tab (Archive, Import and Restore) on or off.
  • part_mb is the size limit of one archive part, about 1 GB by default.
  • keep_hours is how long a prepared archive stays on the server, 72 hours by default.

AI assistant

AI features are optional. Each company connects its own AI provider account inside Mailix; see Connect the company AI account. In the configuration file you decide what is possible:

OptionDefaultWhat it does
ai.account_keystrueLets companies connect their own AI account
ai.managersEmptyStandalone only: addresses that may manage the company AI account
ai.featuresAll on except priorityThe AI features users may turn on: writing, replies, summary, translate, tasks, search, phishing, priority
ai.timeout45AI request timeout in seconds
ai.provider, ai.api_key, ai.modelEmptyStandalone only: an optional server-wide fallback key, paid by the server owner
ai.monthly_limit, ai.user_monthly_limit0 (no limit), 500Limits for the server-wide key only

The priority inbox sends new mail to the AI by itself, so it stays off until you allow it with 'priority' => true. Even then, each user turns it on separately.

Demo mode

Set 'demo_enabled' => true to show Explore the demo on the sign-in screen. The demo connects to no mail server and uses built-in sample data:

  • sample messages in English, Turkish and Arabic, including conversations, attachments, a newsletter and a phishing example;
  • contacts, folders, filters, signed-in devices and a storage meter;
  • a sample company AI account with prepared answers, without a real AI provider;
  • two-step verification that can be tried with the demo code shown on the screen.

Sent mail stays in the demo and nobody receives it. Demo data is removed after a day. Adding accounts, the Archive tab and Send feedback are not available in the demo.

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