Open-source telecoms. Operator-controlled.0.7.0-dev / Development preview ↗
Search all guides

Diagnose the stage that failed

A failed activation request and a failed local reconciliation need different responses.

Start with status

Inspect the GUI or JSON status output for pending state and safe last_error and last_error_stage diagnostics. Confirm the endpoint, retained identity and operator service authority. Do not paste activation credentials or private state into public issues.

Verified command example
fwconsole domaintains status --json

Remote failure

A rejected or unreachable provisioning response leaves the previous known-good local state intact. Confirm HTTPS, the complete URL, the correct service and current operator entitlement. Ordinary Activate refuses a different token while retained authorisation exists; deliberate replacement uses confirmed Reactivate.

Local conflict or interruption

A local failure can leave newly authorised state pending. Inspect ownership and actual FreePBX configuration before retrying. Unexpected drift, unowned conflicts or malformed protected state must not be bypassed by deleting files. Fix the reported prerequisite, preserve identity and use a controlled retry.

Symptom-led checks

Symptom-led checks
SymptomInspect firstDo not
Activation cannot reach the serviceComplete HTTPS URL, valid certificate and provider availabilityDisable TLS verification or append an assumed API path
Different token refusedRetained activation state and whether deliberate Reactivate is appropriateErase the signing key to force first-use binding
Ownership conflictActual native object and recorded fingerprint; administrator changesDelete the ledger or silently adopt the object
Pending after interruptionSafe last_error stage and recorded original/pending evidenceTreat every pending state as success
Search blocked or queuedOwned context, nonce, session quota and shared limiterRetry automatically or use a second limiter file
Emergency status is not registeredExplicit provider confirmation and current assignment authorityMap a successful HTTP response to confirmed registration