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

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":

If you can't access OctoPrint's web interface for some reason, you can also retrieve the log files via SSH with an SCP client such as WinSCP.

The logs 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.
Is there utility in a monitor for Octopi setup on a Pi?
After 1.3.10 update can't connect to the printer
Webcam wont load/show up
Printer Doesnt Start
Druckabbruch bei Verbindungsaufbau durch Octoprint-Pressure aborted when connecting through Octoprint
Putty is displaying an error
Octoprint disconnects after print
Updated and now cannot connect
Octoprint on connecting to printer moves x and y axis and crashes into ends. HELP
Octoprint and Geeetech Smartto firmware
Printing stops, throws a "SerialException" error
Octopi disconnect when changing filament
Z axis running to high
CR10sPRO / Tiny Machines 2.0 FW / M600 / Octoprint - any success?
Installed desktop from octopi wifi setup and now my usb ports no longer are powered
New user with Makerbot Replicator 2x
Moves to back corners and spews filament
Strange Octoprint behavior
Octoprint won`t start a print from SD Card
Octoprint / Lulzbot Workhorse... smoke!
Can't Connect to Octopi
Filament Run Out sensor not working
Webcam don't stream
Prusa i3mk3s mmu2s not connecting
Octopi to printer connection problem
Cannot connect to Octoprint from PC
OctoPrint Home Screen
My OctoPrint won't use terminal at all
FLSUN QQ-S some problems
Upgrade to 1.4 broke printing
Teminal problems
Y Axis randomly stops mid Print - Ender 5 Silent
Octoprint causing random layer shifts
Octoprint causing random layer shifts
I can't install plugins in my octoprint! (I don't have Internet connectivity)
Octopi not connect to wifi
After OctoPrint firmware update plugin update - Prusa i3 MK3 will no longer connect
RPi 3won't connect to Ender 3 after 3 weeks of working
Prusa i3 MK3S + Pi Zero W + Pi Camera V2.1 = No video stream
Z height randomly dropped mid-print, causing nozzle to dig into the print
I can no longer upload files
Octoprint resets my bed leveling
Unsupported command
Extruder only moves along X-axis Mid-Print
Bad connection to octopi
Octoprint Crashing
Teminal problems
Terminal does not work
Please Help. Connect Ender 3 Pro to Octoprint after moving Z around. Now not able to moving Z anymore
Please Help. Connect Ender 3 Pro to Octoprint after moving Z around. Now not able to moving Z anymore
Connecting to Printer failed but not failed
Printer stops mid-printing
Raspberry pi 3B+ mem bottleneck
Creality CR-10 Not getting Baudrate
Octoprint no connection to web-interface
Temperature reporting now working with new ender 3 V2
Pi cam not working, what gives