Licensing portal online

01 / Activate

Activate a license.

A license is a signed token installed on the Alt8Mail host. The product verifies it locally; the portal is not in the mail path.

Before you start

  • An Alt8Mail deployment with System Control reachable.
  • The deployment ID from Control → Infrastructure → License.
  • Permission to upload a license and restart the webmail service.

The guided route

  1. 01
    Open the license page.

    In Control, select One-click upgrade. Control opens the licensing portal with the deployment ID and a callback URL.

  2. 02
    Choose a trial or plan.

    The portal returns a signed token and, when published, the enterprise release metadata to Control.

  3. 03
    Claim once.

    Control exchanges the one-time claim, verifies the signature and writes the shared token file. The claim is bound to the deployment.

  4. 04
    Restart the webmail.

    Control shows the exact restart instruction. The webmail verifies the token at startup; Control re-reads it on every status request.

Manual activation

If the deployment is air-gapped or Control cannot reach the portal:

  1. 01
    Download the token.

    From Account → Licenses, download alt8mail-license.token.

  2. 02
    Upload it in Control.

    Use the license upload form. Control verifies it before touching the file and preserves the previous file if anything fails.

  3. 03
    Restart the webmail.

    The token is not hot-reloaded by the webmail. Restart a8m-server after a successful upload.

Verify the state

StateWhat it means
validPaid features and the licensed seat limit are active.
graceThe expiry date has passed but the signed grace window remains. Paid features stay active.
expiredPaid features are disabled; core mail continues. Existing users are grandfathered.
unlicensedNo token configured or the configured file is absent. Community behavior.

Troubleshooting

Control rejects the token as expired

Check the server clock and the token’s expiresAt. Expired tokens are intentionally refused on upload. Request a reissue from the portal or your account manager.

The webmail still shows Community after upload

The webmail reads the token at startup. Restart the webmail service. Control may already show the new state because it re-reads the file on every request.

The key ID does not match

The product’s compiled verification ring must contain the kid used to sign the token. Reissue with a current key or update the release trust ring under a controlled rotation.