Diagnostics and troubleshooting
Health checks, enrollment errors, license statuses, log rotation and common issues.
Terms used in this guide
- A reverse proxy accepts external requests and forwards them to MassAccess services.
- Transport Layer Security (TLS) encrypts connections to the public address.
- A health check confirms that a service is ready to handle requests.
- Enrollment binds an installed instance to the created license.
Open On-premise → Webhook Ingress in your local installation to configure the Receiver, connect and check ingress. External DNS/NAT/firewall settings remain your responsibility.
Open On-premise → Webhook Ingress in your local installation to configure the Receiver, connect and check ingress. External DNS/NAT/firewall settings remain your responsibility.
Enrollment errors (HTTP 409)
HTTP 409 indicates an identity/generation/request-body conflict. Do not replace UUID/keys to bypass it: record stage and error enum. Retry pending after central infrastructure recovery. Suspended licensing does not authorize new registration or renewal.
License statuses
A license can be Active or Suspended. Suspension occurs when usage counters diverge or the connection to the license server is lost. When blocked, sending messages is unavailable while the dashboard keeps working.
Docker log rotation
Container logs are rotated with a size limit of 20m and up to 5 retained files.
Common issues
Log noise at startup and dependence on the outbound service for messenger connections. On installation failure, save the full installer message and contact support at info@massaccess.net.