Where can I find OctoPrint's and OctoPi's log files?

general
information
analysis
octopi

#1

To help with problem analysis, it's important to share relevant log files. This FAQ entry is going to tell you where to find the log files of the OctoPrint application and the OctoPi OS image.

:question: Confused about OctoPrint vs OctoPi?

Read this FAQ entry on the difference between the two.

OctoPrint

All log files that OctoPrint writes can be found in the logs sub folder in its configuration directory:

  • on Linux: ~/.octoprint/logs
  • on Windows: %APPDATA%\OctoPrint\logs
  • on MacOSX: ~/Library/Application Support/OctoPrint/logs

You can also access them via OctoPrint's Settings dialog under "Logging":

The logs you find in there are crucial instruments of analysis and debugging, so it's usually in your best interest to provide them when asking for help or reporting a bug, even if not explicitly prompted for them:

  • octoprint.log: OctoPrint's main application log file. Contains a general log of everything that happens while OctoPrint is running. Includes version information, installed plugins and a myriad of more data points.

    This must always be included when reporting a bug to allow for further analysis and reproduction. It is also a very good idea to provide this when asking for help :wink:

  • serial.log: A log of all of the communication going on between OctoPrint and your printer. Usually disabled for performance reasons, enable it through Settings > Serial Connection.

    Either that or at the very least the output in OctoPrint's Terminal tab is crucial for analysis of any kind of communication issues or misbehaviours observed with your printer, so it's important to include it when discussing such issues.

  • plugin_pluginmanager_console.log: A log of the command line activity of the plugin manager. Very important for analysis of such questions like "Why can't I install plugin $xyz?", so if you have such a problem, best include this.

  • plugin_softwareupdate_console.log: A log of the command line activity of the software updater. Very important for analysis of such questions like "Updating OctoPrint always fails, why?", so if you have such a problem, best include this.

Third party plugins might also have special log files here. If a plugin author asks you to provide a special log created by their plugin for further analysis, this should be where you can find it.

OctoPi

On OctoPi there are the following additional log files which you'll have to copy over via SSH or an SCP client such as WinSCP:

  • /var/log/webcamd.log: The log of the webcam server. If you are running into issues with your webcam not being recognized or stopping to work out of the blue, this is the log file that might contain the answer.
  • /var/log/haproxy.log: The log of the reverse proxy in front of OctoPrint and the webcam server, haproxy. If you can't connect to the server in your browser at all ("Connection refused"), this is the log file that might contain the answer.
  • /var/log/syslog: The general system log file. If you are having issues connecting via WiFi, or if your printer is not showing up in OctoPrint, this might give additional clues.

Octopi loses camera
Network error while checking for updates
Extruder only moves along X-axis Mid-Print
Bad connection to octopi
Unable to setup Twilio
Hotend not turning off after updating to 1.3.7
Freezing if I cancel print
When I start a print bed and hotend doesn't heat before start
Instone inventor pro
Need help? READ THIS FIRST!
Prints cancelling mid print?
Octopi and usb webcam
Pip error while upgrading from 1.3.6 to 1.3.8
Serial port connection issue on mac OS X
Server is offline