In this guide, we'll dig into what to do when the SimplyPrint setup guide doesn't detect your device while setting up SimplyPrint, or if you can't find the 4-letter setup code.

First things first; is SimplyPrint installed and enabled?
Often times, the issue is as simple as SimplyPrint maybe not being installed or enabled.

Make sure you have gone through our setup guide, and maybe repeat the steps to see if you missed something
For OctoPrint setups; go to Settings > Plugin Manager and ensure the SimplyPrint plugin is both installed and enabled. If its' grayed out, it's disabled
For OctoPrint setups; make sure OctoPrint isn't in "Safe mode". If a popup says "Safe mode", just restart OctoPrint to get it back in non-safe mode


Make sure you're on the same network
SimplyPrint can only auto-detect your printer if your computer / device you're detecting from, is on the same WiFi / network as the Pi / device running SimplyPrint. So ensure you are indeed on the same network.

Ensure your Pi is powered and connected
Double-check that your Raspberry Pi (or whichever device is running SimplyPrint), is connected to the internet and has been powered on for at least 5 minutes. For older devices, the first boot of the device can take a long time, so just have a little patience with it.

Finding the setup code
If auto-detect doesn't work, a unique setup code given to your device can help you set it up.

If you have access to the local web-interface already (OctoPrint, Mainsail, Fluidd)
If you have the web-interface of either OctoPrint, Mainsail or Fluidd, the setup code should be easy to grab!

For OctoPrint; check the navigation bar in the top of the page and find the SimplyPrint logo. Here, there should also be a 4-letter setup code - this is the one!
For Mainsail and Fluidd; in the little bell-icon, top right in the navigation bar, there should be a message from SimplyPrint containing the setup code

If you can't find the setup code within the web-interface as mentioned, SimplyPrint is most likely not installed correctly - try and repeat the setup.

If you don't have access to the local web-interface of OctoPrint, Mainsail or Fluidd

For this to work, you must be on the same network as the Pi / device you're trying to connect to!
Windows users might need to install "Bonjour" to access the device locally. Download here;

Using the local IP hostname (easy way)
Most computers nowadays support using the "hostname" of a device, to access it via a web browser. So, let's try and reach the web UI!

If you have changed the hostname manually; if you've recently flashed OctoPrint, Mainsail or Fluidd onto an SD card, you might have had the option to change the hostname before flashing. If you've done this, go to; http://[THE_HOSTNAME_YOU_CHOSE].local (replace [THE_HOSTNAME_YOU_CHOSE] with the hostname you chose - do not include the brackets [ ])

For OctoPrint; try and go to http://octopi.local
For Mainsail; try and go to http://mainsail.local
For Fluidd; try and go to http://fluiddpi.local

If this didn't work, try and go to the next step

Finding the local IP address of your Pi / device
If you can't access your device by its hostname, chances are it's not online on the same network, or that something is wrong. But, it's also possible that, for a number of possible reasons, it just wants you to use its actual local IP address. So let's try and find that!

Using a network scanner;
One way to find the IP of your device, is by using a network scanner. We recommend using "[Angry IP Scanner](", but "[fing](" is also an option.
Use one of these scanners, scan your network and see if the device pops ups

Accessing your router's control panel;
Another way to find local IPs on your network, is by going to the control panel of your router. This most often requires you to have an admin username and password.
It varies from router to router where this control panel page is found, so please Google the make and model of your router to check, or consult your internet provider.

Plugging in a monitor and a keyboard (Raspberry Pi's);
When using a Raspberry Pi, you can plug in a keyboard and a monitor, and on the start-screen it will most often tell you the local IP address if there is one.

A more detailed description digging in to finding the local IP address can be found on the OctoPrint forums here;

Still having trouble? Open up the chat and we'll help you!
Was this article helpful?
Thank you!