Luxa Mailbox — Installation & License Setup Guide

• WordPress 6.2 or later.
• PHP 7.4 or later.
• The PHP imap extension enabled on your server. Most cPanel/DirectAdmin hosting has this on by default. If it’s missing, Luxa Mailbox will tell you exactly that on the Mailbox screen, with a link to instructions — you don’t need to guess.
• Your mailbox’s IMAP and SMTP connection details (host, port, username, password) from your email provider or hosting control panel. If you’re not sure where to find these, check your host’s “Email Accounts” or “Mail Configuration” page, or search “<your provider> IMAP SMTP settings”.

1. In wp-admin, go to Plugins → Add New Plugin, search for “Luxa Mailbox”, and click Install Now, then Activate. (Alternatively: download the ZIP from WordPress.org or your account at luxapress.com, then use Plugins → Add New Plugin → Upload Plugin.)
2. A new Mailbox item appears in your admin sidebar. Go to Mailbox → Settings.
3. Enter your IMAP details (host, port, encryption, username, password) and your SMTP details, then click Test IMAP connection and Test SMTP connection to confirm both work.
4. Click Save. Go to Mailbox — you’re now reading and sending email from inside WordPress.

No license or account is required for the free plugin — it works indefinitely with one mailbox.

2.1 — Purchase and download

1. Purchase Luxa Mailbox Pro at luxapress.com. After checkout, your license key is emailed to you and also available in your luxapress.com account dashboard under My Licenses — keep this key somewhere safe, you’ll need it in a moment.
2. Download the Luxa Mailbox Pro plugin ZIP from the same account dashboard.

2.2 — Install Pro

Luxa Mailbox (free) must already be installed and active. Pro is an add-on to the free plugin, not a replacement for it — do not deactivate or delete the free plugin after installing Pro.

1. In wp-admin, go to Plugins → Add New Plugin → Upload Plugin, choose the Luxa Mailbox Pro ZIP you downloaded, click Install Now, then Activate.
2. New items appear in your sidebar: License, Mail Accounts, Canned Responses, Add-ons, and Modules. Everything works in a limited/preview capacity until you activate your license (see next step) — you won’t lose access to the menu items themselves while unlicensed, so you always have somewhere to go paste your key.

2.3 — Activate your license

1. Go to License in the sidebar.
2. Paste the license key from your luxapress.com account, and click Activate License.
3. Once activated, the page shows your license status, plan, and expiration/renewal date.

“Activation limit reached”? Your license key allows a limited number of active sites at once (check your plan for the exact number). If you’ve reached it, the License page lists every site currently using this key, each with a Deactivate this domain button — deactivate one you no longer use, then activate on the new site.

Moving to a new domain? Deactivate the license on the old domain first (from the License page while it’s still working there, or from your luxapress.com account dashboard if the old site is no longer reachable), then activate it on the new one.

2.4 — Set up your mailboxes

Go to Mail Accounts and add each mailbox you want to manage — your original free-plugin mailbox is carried over automatically as your first account. See the User Guide for full details on managing multiple accounts.

Add-ons are separate, optionally-purchased plugins that extend Luxa Mailbox Pro. Each one needs both an active Pro license and its own separate license key.

1. Purchase the add-on at luxapress.com. You’ll receive a separate license key for the add-on itself — this is different from your Luxa Mailbox Pro key.
2. In wp-admin, go to Add-ons. Find the add-on’s card in the catalog.
3. Click Unlock, paste the add-on’s own license key in the dialog that appears, and click Unlock again to confirm. The card now shows Licensed.
4. Click Install Now. WordPress downloads and installs the add-on’s plugin files — this can take a few seconds.
5. Click Activate. The add-on is now running.

To turn an add-on off later, click Deactivate on its card. To remove it entirely, deactivate it first, then click Uninstall. Uninstalling removes the add-on’s plugin files but keeps its license unlocked — reinstalling later won’t ask you to re-enter the key.

Why does the add-on say it’s not licensed even though I entered a valid key? An add-on’s own license being valid is not enough on its own — it also requires your Luxa Mailbox Pro license to be active. If your Pro license has expired or was deactivated, every add-on stops working until Pro is licensed again, regardless of the add-on’s own key. See License to check your Pro license status.

“The PHP IMAP extension is missing.” Ask your hosting provider to enable the imap extension for your site’s PHP version (cPanel: Select PHP Version → Extensions → imap). This is a standard, widely-supported extension — most hosts can enable it within minutes.

Test connection fails, but I’m sure my password is correct.

• Double-check the port and encryption setting — a mismatch (e.g. SSL selected on a port that expects TLS, or vice versa) is the most common cause.
• Some providers (Gmail, Outlook/Microsoft 365 among them) require an app password rather than your normal account password when a third-party app connects via IMAP/SMTP, especially with two-factor authentication enabled. Check your provider’s account security settings for how to generate one.
• Some hosts block outgoing SMTP on the default port; try your provider’s alternate port (587 is common for TLS SMTP) if the primary one fails.

I don’t see the Mailbox menu after activating. Confirm the plugin is actually active, not just installed (Plugins list, look for the “Deactivate” link rather than “Activate”). If it’s active and the menu still doesn’t appear, check with your site administrator whether your WordPress user account has the required capability (manage_options — typically any Administrator-role user).

“Sorry, you are not allowed to access this page” on a Luxa Mailbox Pro screen. Make sure Luxa Mailbox (free) and Luxa Mailbox Pro are both on their latest versions — this message can appear on outdated combinations of the two. Update both plugins, then reload the page.

I activated my license but Pro still shows as unlicensed. Click Activate License again on the License page — occasionally a slow connection to the license server can cause the first attempt to time out. If it persists, confirm the key was copied without extra spaces, and that the domain you’re activating on matches what’s expected for your plan (some plans are single-site only).

Still stuck? Contact support through your account at luxapress.com — include your license key, your WordPress and PHP versions (found at Tools → Site Health → Info), and a description of what you tried.