Existing licenses & billing
Activate an existing license, manage billing, handle offline use, and recover from license errors.
The complete local SiteCMD workbench is free and has no license-controlled feature gate. License support remains in the app for existing subscribers and for credentials that authorize connected-service or maintained-catalog access.
Connected-service access is comped during the founder beta. There is no public beta purchase flow and no public connected-service price yet. See Pricing & connected service for the current commercial boundary.
Activating an existing license
If you purchased SiteCMD previously, LemonSqueezy sent a license key by email.
- Open SiteCMD.
- Go to Settings → Account → License key.
- Paste the existing license key.
- Click Activate.
SiteCMD validates the key, registers the machine when required by the purchase, and restores the connected-service or maintained-catalog credentials associated with it. Activation does not change the local scan payload, issue detail, MCP tools, reports, or exports.
If activation fails, the error message identifies the likely cause:
- License not found: the key was mistyped or belongs to another store.
- Activation limit reached: the purchase’s machine allowance is already in use.
- License expired: the existing subscription did not renew.
- Network error: the machine cannot reach
api.lemonsqueezy.com; see Troubleshooting.
Founder-beta participants should follow the access instructions provided during onboarding rather than purchase an old public plan.
Where the license lives
The license key is stored in the operating system credential store: Keychain on macOS, Credential Manager on Windows, or GNOME Keyring/KWallet on Linux. It is not stored in the SiteCMD SQLite database.
Activation state is cached locally for fast startup and refreshed after a successful validation.
Validation cadence
For an existing license, SiteCMD validates:
- On startup, using a recent cached result and performing a live check when the cache is stale
- Periodically while the app is running
- On demand when you click Refresh License
A successful validation extends the offline grace window. A failed network request does not immediately revoke connected-service or catalog access.
Offline grace period
When SiteCMD cannot reach the license server, an existing license enters an offline grace period. During that window, its connected-service and maintained-catalog credentials continue to work where the network itself is available.
After the grace period, those credentials can pause until validation succeeds. The complete local workbench does not pause: local scans, full issue detail, fix guidance, correlation, MCP, CLI artifacts, reports, exports, and stored project data remain available.
Existing renewals and cancellation
Existing subscriptions continue under the price, renewal, allowance, and refund terms shown at purchase. LemonSqueezy sends renewal and payment-status messages for those subscriptions.
To update a payment method, inspect the purchase, or cancel future renewals, visit the SiteCMD billing portal with the purchase email. The same link is available from Settings → Account → Manage Billing.
Cancellation stops future renewals and leaves the license active through any period already paid for. When that entitlement ends, local product capabilities remain available; only credentials tied to the ended commercial entitlement stop refreshing.
Moving an existing license
The activation allowance is the one attached to the original purchase and shown in the billing portal.
- If the old machine is available, deactivate the license from Settings → Account there.
- Activate the same key on the new machine.
- If the limit is still reached, remove the old activation in the LemonSqueezy portal and try again.
The catalog credential service tracks its own installations. If the new machine activates but maintained catalog updates do not arrive after a lost-machine move, contact support@sitecmd.com. Support can release the stale catalog installation without changing local access.
Refunds
Founder-beta connected-service access is comped, so there is no beta purchase to refund. Existing purchases keep the refund terms shown at purchase. Cancel through the billing portal to stop future renewals, or contact us with a question about a charge.
What billing records contain
For accounting and tax compliance, the payment processor retains the purchaser, date, amount, and subscription state for an existing purchase.
Billing records do not contain your source repository, local scan history, project database, or integration credentials. Connected-site data is governed separately by the explicit connected-service data boundary in Privacy & data.
When something goes wrong
“My existing license stopped working.” Check Settings → Account for the specific status, then use Refresh License. Common causes are an expired payment method, a cancelled subscription, or a network block against the validation host.
“I lost my license key.” Sign in to the billing portal with the purchase email. Existing keys are listed with the purchase.
“The app says Free even though I have an existing license.” Confirm the key belongs to the SiteCMD store and use Refresh License. The label does not change the complete local feature payload; it only reflects the commercial credential state.