Skip to main content
Every installation of the OctoEverywhere has a log file that is useful for finding issues and debugging.
The plugin logs can contain private information - keep them private.
If you installed Bambu Connect, Elegoo Connect, or the Klipper Companion via SSH using the command line, you must retrieve your logs from the device on which the plugin is running.
  1. SSH into the device running the OctoEverywhere plugin.
  2. Go to your user home.
    1. cd ~
  3. Depending on your plugin type, look for a directory as follows. If you have multiple plugins, there will be a -# appended to the directory name.
    1. Bambu Connect
      1. ~/.octoeverywhere-bambu/
    2. Elegoo Connect
      1. ~/.octoeverywhere-elegoo/
    3. Klipper Companion
      1. ~/.octoeverywhere
  4. In the OctoEverywhere data root, the log path is:
    1. <plugin data root>/log/octoeverywhere.log
If you’re using a terminal such as MobaXterm, you can use the tool UI to copy the file to your local device. If you’re SSHing from the terminal, you can use a command like
scp <linux user>@<device IP address>:~/.octoeverywhere-elegoo/log/octoeverywhere.log ~/octoeverywhere.log
This SCP command copies the log file from the remote device specified by its IP address to the home directory on the device you’re on.
If you’re using the Docker container for any plugin type, your log files are located in the mapped Docker data folder root.
<docker data roo>/log/octoeverywhere.log
Mainsail:
  1. Enable Debug Logging
    1. Open the Mainsail web UI
    2. Click Machine in the left navigational menu
    3. In the Config Files section, find the file named octoeverywhere.cfg
    4. Click octoeverywhere.cfg to open it for editing.
    5. Change log_level = INFO to log_level = DEBUG
    6. Click Save & Restart at the top right.
  2. Reproduce The Issue
    1. If you can reproduce the issues on demand, reproduce them and capture the logs.
    2. If not, wait until you see the issues again, and then try to capture the logs ASAP.
  3. Capture The Logs
    1. Open the Mainsail web UI
    2. Click Machine in the left navigational menu
    3. In the Config Files section, find the box labeled root. The box defaults to the value config as the root.
    4. Change the root drop-down to logs.
    5. Find the most recent octoeverywhere.log file.
    6. Right-click the log file and select Download.
Fluidd:
  1. Enable Debug Logging
    1. Open the Fluidd web UI
    2. Click Configuration in the left navigational menu
    3. In the Config Files section, find the file named octoeverywhere.cfg
    4. Click octoeverywhere.cfg to open it for editing.
    5. Change log_level = INFO to log_level = DEBUG
    6. Click the disk save icon at the top right.
    7. Click the X to close the config editor.
    8. Restart the device to ensure the new logging level takes effect.
  2. Reproduce The Issue
    1. If you can reproduce the issues on demand, reproduce them and capture the logs.
    2. If not, wait until you see the issues again, and then try to capture the logs ASAP.
  3. Capture The Logs
    1. Open the Fluidd web UI
    2. Click Configuration in the left navigational menu
    3. Scroll down to the box labeled Other Files
    4. Be sure the LOGS tab is selected, it should be by default.
    5. Find the most recent octoeverywhere.log file.
    6. Click the log file and select Download.
Once you have your logs, please share them with our OctoEverywhere support team. We are happy to look into your issue and help! 🥰
Here’s how to get your logs:
  1. Open your OctoPrint web portal.
  2. Open the OctoPrint settings
  3. Go to “Logging” in the settings
  4. Delete your current logs:
    1. Find the log row that says “octoprint.log”
    2. Click the trash can icon to delete it.
  5. Set Logging Level:
    1. Under “Logging Levels” find “octoprint” and make sure the value is DEBUG
  6. Press “Save” to close the settings UI
  7. Reproduce your issue - ideally a few times.
  8. Restart OctoPrint:
    1. Click the power icon in the top right of OctoPrint’s web portal
    2. Select “Restart OctoPrint”
  9. Go back to the OctoPrint settings, then to the Logging settings panel.
  10. Find the “octoprint.log” file row and click the download icon.
Once you have your logs, please share them with our OctoEverywhere support team. We are happy to look into your issue and help! 🥰