License activation
Activate a key, verify it offline and understand the grace period.
Where the license lives
Open Admin → System. The License card shows the current state: plan, domain, support and updates end dates, and the masked key.
A license is a signed file, not a phone-home check. The signature is verified locally with an Ed25519 public key that ships inside the product, so the storefront never depends on our server being reachable.
Activate with a key
- Paste the key from your purchase email, in the form
SCENE-XXXX-XXXX-XXXX-XXXX. - Press Activate. The site sends the key and its domain to the license API and receives a signed license file.
- The file is stored in the database and verified immediately. The card switches to Active.
The key format carries a checksum, so a typo is rejected locally before any network request.
Activate with a file
If the server has no outbound access, download the license file in the client area and use Import license file on the same card. The result is identical.
Offline grace
Activation needs one successful network call. After that the license is valid offline indefinitely; the site re-checks once a week in the background.
If the weekly check cannot reach the API, nothing breaks: the admin panel shows a quiet notice after fourteen days of silence. The storefront keeps selling.
Domain and free hosts
A license is bound to one production domain. Moving it to another domain is done in the client area, three times per year.
localhost, *.local, *.test and any host containing staging are free: they never occupy the license slot, which is why a staging copy works with the production key.
When support ends
The site keeps working on the last installed version forever. What stops is the release channel: Check now in Updates and new installations from the marketplace need a valid license with an active updates window. Everything already installed stays installed.
Renewing support re-opens the release channel for another year.
Development mode
With no license at all the admin panel shows a red banner and the updates and marketplace install buttons are locked. That is the intended development state: content, orders and the storefront are never restricted.
Troubleshooting
If activation fails, check in this order:
SCENE_LICENSE_API_URLin.env— it should behttps://api.scenecms.com/api/v1unless you run your own license server.- Outbound HTTPS from the server:
curl -sS https://api.scenecms.com/up. - The message on the card:
unknown_key,domain_conflictandsuspendedeach have their own meaning, shown verbatim.
A domain conflict means the key is already bound to another host — release it in the client area, then activate again.
Not covered here?
Write to sales@scenecms.com — we answer within one business day.