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
- 01Open the license page.
In Control, select One-click upgrade. Control opens the licensing portal with the deployment ID and a callback URL.
- 02Choose a trial or plan.
The portal returns a signed token and, when published, the enterprise release metadata to Control.
- 03Claim once.
Control exchanges the one-time claim, verifies the signature and writes the shared token file. The claim is bound to the deployment.
- 04Restart 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:
- 01Download the token.
From Account → Licenses, download
alt8mail-license.token. - 02Upload it in Control.
Use the license upload form. Control verifies it before touching the file and preserves the previous file if anything fails.
- 03Restart the webmail.
The token is not hot-reloaded by the webmail. Restart
a8m-serverafter a successful upload.
Verify the state
| State | What it means |
|---|---|
| valid | Paid features and the licensed seat limit are active. |
| grace | The expiry date has passed but the signed grace window remains. Paid features stay active. |
| expired | Paid features are disabled; core mail continues. Existing users are grandfathered. |
| unlicensed | No 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.