Troubleshooting

Start here when something looks off. This guide lists the most common symptoms, where to check logs, and the fastest checks to narrow down the root cause. It walks through the core settings, common workflows, and the checks to run after changes so you can confirm everything is working. Use it when setting up, updating, or troubleshooting troubleshooting.

Panel does not load

  • Check nginx: systemctl status nginx
  • Confirm ports 80/443 are open.
  • Verify DNS points to the server IP.

Agent actions fail

  • Check agent service:
systemctl status jabali-agent
journalctl -u jabali-agent -n 200 --no-pager

Background jobs not running

  • Check queue service:
systemctl status jabali-queue
journalctl -u jabali-queue -n 200 --no-pager

SSL issuance issues

  • Confirm DNS for the domain resolves to the server.
  • Check nginx logs: /var/log/nginx/error.log

Mail delivery problems

  • Verify PTR and DNS records (SPF, DKIM, DMARC).
  • Review mail logs: /var/log/mail.log (path may vary by distro).

Logs

  • Panel logs: /var/www/jabali/storage/logs
  • Nginx logs: /var/log/nginx
  • Systemd logs: journalctl -u <service>