ARN Smart Support
Language: English

Install Mailix on a single domain

Updated 12 Nov 2026 3 min read
Browse Mailix articles

A standalone installation runs Mailix on one domain or subdomain, such as webmail.example.com. Users sign in on Mailix's own sign-in screen with their full email address and password. It works with any IMAP and SMTP server, with or without cPanel.

Before you start

  • Check the server requirements. HTTPS is required for secure cookies and for installing Mailix as an app.
  • Have the Mailix installation package (mailix-install-<version>.zip) from ARN Smart.
  • Know the IMAP and SMTP details of your mail server: host names, ports and encryption.

Install Mailix

  1. Upload the contents of the ZIP file to the document root of the domain or subdomain.
  2. Copy config/config.sample.php to config/config.php.
  3. In config/config.php, set the mail servers under imap and smtp if they are not on localhost on the same server. See Configure Mailix.
  4. Set storage_dir to a folder outside the web root, for example /home/<user>/mailix-storage, and make sure PHP can write to it.
  5. Open the address in a browser and sign in with a full email address and its password.

Note: The default storage folder (storage/ inside the application) also works, but then only the .htaccess file keeps it off the web, and web servers other than Apache ignore that file. A folder outside the web root is safer.

Protect the internal folders

On Apache, the included .htaccess blocks web access to src/, bin/, config/, storage/, tests/, tools/ and cpanel/. On other web servers, block these paths in the server configuration.

Without cPanel

If the mail server is not managed by cPanel, set 'cpanel_api' => ['enabled' => false] in config/config.php. Server filters and automatic replies then are not available. If the server has no CardDAV address book, turn carddav off too; contacts are then kept in Mailix's own storage.

What a standalone installation adds

Mailix standalone sign-in screen with the Phone QR option for signing in a new computer

  • QR sign-in: a new phone or computer can sign in with a QR code that a signed-in device approves. See Signed-in devices and QR sign-in.
  • Offline start screen and app shortcuts for the installed app.
  • Resumable archive downloads: an interrupted archive download continues where it stopped.
  • An optional server-wide AI key as a fallback when a company has not connected its own AI account. See Connect the company AI account.

The weekly automatic reply and AI automatic replies need the server-wide installation on cPanel Webmail and are not available here.

Next steps

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