Skip to main content

Set up Obico for Klipper


This guide is for the users who use Klipper with Moonraker and Mainsail or Fluidd. If you are using OctoPrint with Klipper, please follow the Obico for OctoPrint guide instead.


This guide assumes you are connecting to the Obico Cloud. If you are connecting to a self-hosted Obico Server, you will need to use the address of your self-hosted server.

Hardware requirements​

Before you start, make sure:

  • You have set up Klipper and the Moonraker API correctly, and it is connected to your printer. A interface such as Mainsail/Fluidd is highly recommended.
  • A webcam is set up for your printer and connected to Mainsail/Fluidd/Moonraker.
  • There is sufficient lighting to illuminate the printing area of your printer. If your printer is in a lighted room, you are probably fine. If you'll print with light off, you will need to make sure the printing area is illuminated when your printer is printing. A LED strip or small LED lamp will do the trick.

Step 1: Download Obico for Klipper and run​

  1. Use SSH to connect to the Raspberry Pi your Klipper runs on.
  2. Run the following commands one by one:
    cd ~
git clone
cd moonraker-obico
  1. Follow the guided installation steps on your screen. You may be asked to enter your password in order to run sudo commands.
  2. When asked for additional information about configuration files, provide their location or the appropriate number. Default for Klipper may be:
    1. moonraker.conf configuration file: ~/printer_data/config/moonraker.conf or ~/moonraker.conf (see Moonraker docs)
    2. Moonraker network address: The IP or hostname of the Klipper machine
    3. Moonraker network port: 7125 (HTTP) or 7130 (HTTPS) (see [server])
    4. Log file directory: /logs folder (root level of the disk) (see moonraker.log)
  3. Next, the installation process will ask you to enter details required to link your printer to the Obico server. Provide:
    • The Obico Server you want to link it to. The default is (the Obico Cloud). Alternatively, you can also host your own Obico Server: enter the IP address or hostname of your own server (e.g.
    • A 6-digit verification code. Leave the terminal window open on this screen.
  4. Follow the guide outlined in Step 3 to either link your Klipper machine and Obico automatically, or obtain the 6-digit manual verification code.
    • If the automatic linking process is successful, the prompt in the terminal will automatically be skipped.
    • You do not need the 6-digit code if automatic linking can be performed.

Step 2: Sign up for an Obico account.​


Follow instructions in the "πŸ“± Mobile App" tab if you are using the Obico mobile app, or the "🌐 Web App" tab if you are using the web app.


Your Obico account is the same for the mobile app and the web app. If you sign up for an account using the mobile app, you can sign in to the web app later with the same email and password. And vice versa.


All functions are available equally in the mobile and the web app. However, with the mobile app, you can receive push notifications on your phone to easily track the print progress, and get alerted in case a failure is detected.

  1. Download the Obico app from the Apple App Store or Google Play Store.
  2. Open the mobile app. Click through the first time tour and then tap β€œLet’s Go!”.
  3. Simply tap "YES!" on the "Hardware Required" screen.
  4. Tap "Sign Up/Sign In" button to proceed to the sign up/sign in screen.
  5. Sign up with your email, Google or Facebook account. If you have already registered, click the "Sign In" button and sign in to your account.

If you are connecting to a self-hosted Obico Server, press the wrench icon (πŸ”§) on the top-left corner of the sign-up screen to change the server address.


If your phone or computer is one the the same local network as your Klipper is, the Obico app can find your Klipper machine automatically. This is the easiest way to link your printer to your Obico account.

  1. Press "Link Printer" button on the welcome screen. If you don't see that screen, tap the menu icon (☰) on the top-left corner, and select "Link New Printer".
  2. Choose "Klipper" on the next screen.
  3. Assuming you have followed the previous steps and installed the plugin, you can simply click the "Yes, Obico for Klipper is installed" button.
  4. The app will start scanning for the Klipper printer connected to the same local network.
  5. If printer is found, simply click the "Link" button and the app will do the rest for you.

    If, however, the app can't find your printer after 1 minute of scanning, you need to follow the Manual Setup Guide to link your printer using a 6-digit code.

6. Optionally, you can now give your printer a name. If you skip this step, your printer will have the default name "*My Awesome Cloud Printer*".

Step 4: Restart the Raspberry Pi.​

Once the Raspberry Pi has booted up, you should be able to see your printer and the webcam stream in the Obico app.

What's next?​

Check out your printer feed!​

Press "Go Check Out Printer Feed!" to see everything you care about your printer: the webcam feed, heater temperature, time remaining on the print job, and more! Remember, you can see your printer feed anywhere you go, as long as you have an internet connection on your phone!

Test the magical failure detection!​

The Detective sounds too magical to be true? See The Detective in action for yourself.

Change printer settings.​

The default settings for your printer in The Spaghetti Detective are the ones that most users find the most reasonable. But feel free to tweak them to your liking:

  • Change notification settings (mobile app only). By default you receive push notifications when The Detective finds something fishy, and for the status of whatever your printer is printing. But you can choose to receive a lot more.
  • Change printer settings, such as if The Detective should pause your printer when a failure is detected.