Troubleshooting

Start with one command

e4s doctor

The doctor command combines service status, health endpoints, important ports, Nginx, Redis, Feature Guard and filesystem checks.

Web panel does not load

e4s status
e4s health
e4s logs web 200
e4s nginx test
ss -lntp | grep -E ':(80|443|18080)\b'

Agent API is slow or unavailable

e4s agent-health
e4s logs agent 200
curl -fsS --max-time 15 http://127.0.0.1:18081/health

Database problems

e4s db activity
e4s db size
systemctl status postgresql --no-pager
pg_isready -h 127.0.0.1 -p 5432

Redis problems

e4s redis status
redis-cli PING
e4s redis info

License page or entitlement issue

e4s license status
e4s license entitlement
e4s license refresh
systemctl status e4s-license-client.service --no-pager

SSL certificate was not issued

1. Confirm DNS resolves to the correct public IP.
2. Confirm port 80 is reachable.
3. Confirm Nginx configuration is valid.
4. Inspect Certbot certificates and logs.

dig +short panel.example.com
e4s nginx test
certbot certificates

Feature Guard reports changed files

e4s feature-guard verify

Do not baseline the changes until the source modification is understood and approved.