Troubleshooting

In case of errors, the openATTIC WebUI will display popup notifications (“Toasties”) that provide a brief explanation of the error that occured. For most errors, the openATTIC backend will raise a “500 - Internal Server Error” HTTP error, writing a more detailed Python traceback message to the openATTIC logfile.

openATTIC log files

The main log file to consult in case of errors is the file /var/log/openattic/openattic.log. This log file is written by the openATTIC Django application and should provide a detailed error message including the traceback that explains which Python module the error originated in.

The second log file that should be checked for errors is the openATTIC systemd log file located at /var/log/openattic/openattic_systemd.log.

Other logfiles worth checking in case of errors include the Apache HTTP server’s error log. Its location depends on the Linux distribution that openATTIC has been installed on - please consult the distribution’s documentation for details.