Troubleshooting

Usually there is not much that can go wrong with the plugin. Generally it just needs to be running and all should be well!

First step: Did you turn it off and on again?

Sounds stupid, but as with any technology this is a magic trick. Try it with your phone and printer ;)

Check if you are up to date

While I do my best to keep everything compatible, old apps might not work with new plugins or vice versa. Make sure that:

• You are using an up-to-date version of OctoApp on your phone. Check the App Store or Google Play Store for updates!
• You are using an up-to-date version of the OctoApp Companion plugin. Check the update section in the Mainsail or Fluidd webinterface for updates!

Common issues

I don't get notifications

Make sure you gave OctoApp the permissions to show notifications. OctoApp supports notifications for:

• Print start
• Print end
• Filament change (depends on printer setup)
• Print paused (on Moonraker, Filament change is a "pause")
• First layer completed
• Third layer completed

Please note that Live Activities on iOS are part of the paid supporter perks, this is due to the high volume of notifications required to make Live Activities work rerliable.

The notifications for first and third layer are wrong

Unfortunalty it's really hard to know when a layer really ends. While I do my best, depending on your print settings these notifications might fire too ealry or too late.

I have the plugin installed, but the app doesn't see it

This can have a couple of reasons. Generally, make sure the following thinks are ok:

Check if the plugin is running (Klipper)

You might have accidentally stopped the service on your printer that runs the OctoApp plugin. To ensure everything is running, log in via SSH (see below) and run sudo service octoapp status to get the current status. You should see active (running). If this is not the case, use sudo service octoapp start to start the plugin. Make sure to restart the app (swipe out of recents) to ensure the app picks up that the plugin is running now. On Android in case you have any ongoing print notifications: use the "Pause notifications" button on any ongoing print notifications before swiping the app out of the recents. Otherwise the app is not properly restarted.

Check the logs look good (Klipper)

Log in on your printer via SSH (see below) and run less ~/printer_data/logs/octoapp.log. You will now see the logs of the plugin. Look for any obvious errors.

Check OctoPrint is not running in Safe Mode

Sometimes your OctoPrint might be running in Safe Mode, this disables all 3rd party plugins, including OctoApp

Check the plugin is not disabled (OctoPrint)

• Open the OctoPrint webinterface and then the settings
• Select "Plugin manager" on the left
• Search for OctoApp and make sure it's enabled