Skip to main content

Link OctoPrint with a 6-digit code

Follow this guide in one of these 2 rare cases:

  • You are trying to re-link OctoPrint. There are only a few reasons why you need to re-link OctoPrint.
  • Your OctoPrint can't be identified at the last step in The Spaghetti Detective Setup Guide. You don't need a 6-digit code if your OctoPrint can be identified and linked automatically.
caution

If you are setting up The Spaghetti Detective for the first time, you should follow The Spaghetti Detective Setup Guide first. Please DO NOT PROCEED if you haven't done so.

Step 1: Launch the Setup Wizard in the plugin#

note

Most of the time the Setup Wizard will automatically launch when you open OctoPrint. Skip this step if it's the case.

  1. Open OctoPrint page in a browser.
  2. Open OctoPrint settings page by clicking the wrench icon (๐Ÿ”ง).
  3. Scroll down to the bottom of the list on the left-hand side.
  4. Click "Access Anywhere - The Spaghetti Detective".
  5. Click "Troubleshooting".
  6. Scroll down to the bottom, and click "Re-run Wizard".

Install the Plugin

Step 2: Follow the Setup Wizard#

note

Follow instructions in the "๐Ÿ“ฑ Mobile App" tab if you are using The Spaghetti Detective mobile app, or the "๐ŸŒ Web App" tab if you are using the web app.

  1. Click the "Setup Plugin" button.
  2. On the next page, click on โ€œContinue with Mobile App".
  3. Since you have already downloaded the mobile app and signed up for an account, just click โ€œContinueโ€ here.
    caution

    If you haven't signed up for an The Spaghetti Detective account, stop here and follow The Spaghetti Detective Setup Guide first.

  4. Now you should see a page that asks you for a 6-digit verification code. Keep this browser tab open while you obtain the 6-digit code in The Spaghetti Detective app.

TSD Wizard Page

Step 3: Launch the "Link OctoPrint" wizard in The Spaghetti Detective app#

note

If you wan to re-link OctoPrint to an existing printer, you should do step 3a instead.

  1. Open The Spaghetti Detective mobile app. You should see a screen with a big "Link OctoPrint" button. If you don't see that screen, tap the menu icon (โ˜ฐ) on the top-left corner, and select "Link New Printer".

Step 3a: Launch the "Re-Link OctoPrint" wizard in The Spaghetti Detective app#

note

If you want to link OctoPrint to a new printer, you should do step 3 instead.

  1. From the printer screen, click the kebab menu (โ‹ฎ) on the top right of the screen.
  2. Click "Configure ๐Ÿ”ง".
  3. Scroll down to the bottom and click "Re-link OctoPrint".

Step 4: Obtain the 6-digit code in The Spaghetti Detective app#

  1. Assuming you have followed this Setup Guide and installed the plugin, you can simply click the "Yes, plugin is installed" button.
  2. On the next screen, if it is stuck in "Scanning..." for more than 1 minutes, tap the "Manual Setup" link.
  3. Tap "I'm ready now" on the next screen.
  4. Now you will see a screen with a 6-digit verification code. This is the code you will use the manually link OctoPrint. You can long-press the number to copy it to the clipboard.

Step 5: Enter the 6-digit code in the plugin Setup Wizard#

  1. Go back to the browser tab in which your OctoPrint is open.
  2. Enter the 6-digit code you obtained in the previous step. You can press Ctrl-V (Windows) or Cmd-V (Mac) to paste the code if you have previously copied them in the clipboard.
  3. Restart OctoPrint. This is necessary only if you are re-linking OctoPrint.

Hooray! You are done! You can close the Setup Wizard window now.

Step 6 (optional): Give your printer a shinny 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".