Troubleshooting OpenAdmin UI Errors

500 Error​

If a 500 error occurs in the OpenAdmin UI, enable dev_mode and tial to log to see the exact command run and response.

If you need assistance, you can copy the message to our support forums or Discord channel for help troubleshooting.

UI Not Responding​

If a feature isn’t working as expected (like clicking a button with no response) it is likely a front-end issue.

To troubleshoot:

1. Open your browser’s Developer Tools (usually F12 or Ctrl+Shift+I / Cmd+Option+I).
2. Navigate to the Network tab.
3. Repeat the action that’s not working.
4. Check for requests in the Network tab and any errors in the Console log.

• Selecting a request in the Network tab allows you to view the response returned by the backend.
• If the response doesn’t contain enough information to diagnose the issue, enable dev_mode on the server and check the Docker logs.

Dev Mode​

Enabling dev_mode allows OpenPanel and OpenAdmin interfaces to log detailed debugging information for every request. This helps administrators see the exact commands run by the panel and the responses received.

To enable dev_mode:

opencli config update dev_mode true

Then restart the panel.

When dev_mode is enabled, detailed logs for the user panel are available via:

tail -f /var/log/openpanel/admin/error.log

These logs provide verbose debugging information for troubleshooting.