Skip to main content

Manually Link Klipper with a 6-digit code

caution

If you are on Obico for Klipper version than 1.6.0 or newer, switch to Updated Manual Setup Guide to link your printer using a one-time passcode.

Follow this guide in one of these 2 rare cases:

  • You are trying to re-link your Klipper printer. There are only a few reasons why you need to re-link printer.
  • Your printer can't be identified at the last step in Obico for Klipper setup guide. You don't need a 6-digit code if your printer can be identified and linked automatically.
caution

If you are setting up Obico for the first time, you should follow Obico for Klipper setup guide first. Please DO NOT PROCEED if you haven't done so.

caution

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

info

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.

Step 1: Download Obico for Klipper and run install.sh​

  1. SSH to the Raspberry Pi (or other SBC) your Klipper runs on.
  2. Run:
    cd ~
    git clone https://github.com/TheSpaghettiDetective/moonraker-obico.git
    cd moonraker-obico
    ./install.sh
  1. Follow the installation steps. You may be asked to enter the password in order to run sudo commands.
  2. You will also be asked to enter the configurations necessary for the installation to complete, such as the location of your moonraker.conf, Moonraker's port and address, and the log directory.
  3. install.sh will now start the process to link your printer to the Obico server. You will be asked to enter:
  4. Leave the terminal open. We will come back to enter the 6-digit code once we obtain it from the Obico app.

Step 2: Sign up for an Obico account.​

tip

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.

info

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.

info

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.
info

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.


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

Step 4: Obtain the 6-digit verification code​

  1. Choose "Klipper" on the next screen.
  2. Assuming you have followed the previous steps and run the install.sh script, simply press "Yes. Obico for Klipper is installed".
  3. Now you will see a screen with a 6-digit verification code. This is the code you will use to link your printer. You can long-press the number to copy it to the clipboard.

Step 5: Enter the 6-digit code​

  1. Go back to terminal for your SSH session in Step 1.
  2. Enter the 6-digit code you obtained in the previous step.
  3. As the final step, you will be asked if you want to opt in bug reporting. We strongly recommend you answer "Y" here. Bug reporting will help us catch and fix bugs earlier and more easily, and hence a better Obico app for you! :)

Step 6: 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.

Step 7 (optional): Give your printer a shiny name!​

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