OctoPi (Raspberry Pi) Not Connecting to WiFi – How to Fix It?

While setting OctoPi up is a pretty straightforward process, with the Raspberry Pi Imager tool taking care of most things automatically, the fact that you only get one shot at correctly configuring the wireless network, combined with there being no way to tell whether there’s a problem (unless you hook your Pi up to a monitor, of course), can make it challenging to get things in working condition.

In this guide, we will explain how you can fix the issue of the Raspberry Pi, which runs your OctoPi server, not connecting to your home wireless network as intended, which practically causes it to be unusable until you resolve the problem as it becomes impossible to reach the OctoPi dashboard from your computer.

OctoPi (Raspberry Pi) Not Connecting to WiFi – How to Fix It?

As an OctoPi server not being able to connect to WiFi is often a product of a mistake during the wireless network configuration, which is a process that takes place when you’re installing OctoPi on your Raspberry Pi for the first time, correcting the configuration usually fixes the problem provided that there isn’t an issue regarding the network itself.

For this process, the first course of action is to wire a keyboard and a monitor or an ethernet cable to your Raspberry Pi, as this will provide you with means to access the terminal where you can see the WiFi status and correct the configuration.

As we will assume that you have used the keyboard & monitor path for the purposes of this guide to keep things simple and to the point, we highly recommend referring to the remote access section in the official Raspberry Pi documentation to get the terminal up and running with SSH if you have chosen the ethernet cable route.

Once you have access to the Raspberry Pi terminal, you will come across a login screen where you will need to enter a username and a password, which, by default, are pi for the username and raspberry for the password after installing OctoPi without overriding the default username & password combination in the advanced options section of Raspberry Pi Imager.

raspberry pi octopi terminal login

After inputting the username and the password, which will grant you admin access to your Raspberry Pi, the next step you will need to take is to bring up the configuration screen by running the command sudo raspi-config in the terminal, where you will find all the options that allow you to configure your Raspberry Pi, whether it’s modifying the WiFi settings or changing the password.

raspi config main screen

Once you see the configuration screen, the next step you will need to take is to navigate to the System Options menu.

Next, navigate to the Wireless LAN menu, which will bring up an input where you can input the SSID of the wireless network you would like to connect your Raspberry Pi (and hence OctoPi).

raspi config wireless lan

Now, input your home network name (SSID) into the prompt, ensuring that it’s exactly the same as what you see on the router interface, including case sensitivity and press Enter.

raspi config ssid example

Finally, complete the process by entering the password of your home network into the password prompt that shows up afterward, while once again making entirely sure that it’s correct before moving forward with saving it, as entering the wrong password will end up with your Raspberry Pi being unable to connect to WiFi.

raspi config password example

Additionally, to verify that the Raspberry Pi is indeed connected to your WiFi, you can use enter the ip addr | grep -E wlan0 command, which, provided that there are no issues with the connection, should show a message that includes the local IP of your Raspberry Pi on the home network, such as the example below, where the local IP is

raspberry pi wifi connectivity check

On the other hand, if no IP address is present in the output that appears on the screen when you run the command, such as the example below, this would indicate that your Raspberry Pi is still unable to connect to the WiFi network, in which case we recommend moving on to the next section for further troubleshooting.

raspberry pi wifi connectivity check fail

Additional Tips & Tricks to Get OctoPi to Connect to WiFi

Even though it’s a rare case, if the Raspberry Pi is still unable to connect to your home wireless network, even after ensuring that the configuration is correct, there are a few more extra steps you can go through, as it’s entirely possible for one of these factors to be causing the problem in your case.

Bring the Raspberry Pi Closer to the Wireless Signal

Provided that you have entered the SSID and the password correctly, the most common problem that can lead to OctoPi not connecting to your WiFi network is the wireless signal not reaching your Raspberry Pi, which can be the case if there is a lot of distance (and obstruction, such as walls) between your Raspberry Pi and your wireless router.

Our recommendation to rule this possibility out in the most reliable way possible would be to place your Raspberry Pi right next to the source of the wireless signal, whether it’s a router or an access point, and see whether the connection works with this setup.

In the case where relocating the Raspberry Pi closer to the wireless signal solves the connectivity issues you’ve been experiencing, you can then opt for solutions such as adding another access point closer to the location where you will be placing your Raspberry Pi for, which will provide a more reliable wireless signal, or moving your 3D printer setup somewhere closer to original wireless signal source.

Connect to a 2.4 GHz WiFi Network

Another common problem that can lead to your Raspberry Pi being unable to connect to your home WiFi network is the combination of using an older Raspberry Pi that only supports 2.4 GHz networks (Raspberry Pi 3 Model B and earlier) and attempting to connect to a 5 GHz network, which the wireless module of your Pi won’t be able to detect.

Our recommendation to find out whether this is indeed the case would be to directly log into your router’s interface, where you should be able to both find information regarding the band of the WiFi network you’re using and make the necessary changes to ensure that you have a dedicated 2.4 GHz WiFi network that your Raspberry Pi can connect to.

2.4 ghz wireless example

Provided that your 2.4 GHz WiFi network has a unique SSID separate from the 5 GHz network, your Raspberry Pi should be able to connect to the Internet without any problems once you set the connection up with the SSID of the 2.4 GHz network in particular.

On the other hand, if you don’t have a 2.4 GHz WiFi network active or use a system where both the 2.4 GHz network and the 5 GHz network share SSIDs (known as band steering), you will need to separate the 2.4 GHz network first for your Raspberry Pi to be able to connect to it without issues.

Power your Raspberry Pi with the Official Power Supply

While a less commonly encountered issue, using an unofficial power supply to power your Raspberry Pi can also be the reason behind the connectivity problems you’re experiencing, with community reports stating that this can lead to a scenario where the wireless module isn’t correctly powered.

So, in a case where you’re using a third party power supply to power your Raspberry Pi, our recommendation would be to obtain an official power supply from the Raspberry Pi store, which should guarantee that you don’t come across any issues regarding your Raspberry Pi’s wireless module getting fully powered up as intended.


While there’s no denying that the OctoPi server not connecting to your home network can be an annoying problem to deal with, especially if you’re using a Raspberry Pi for the first time, purely for the purposes of setting OctoPrint up on it, applying the solution steps should be a breeze for the most part.

That being said, things can get slightly more complicated if the connection problem you’re experiencing isn’t stemming from your Raspberry Pi being configured incorrectly, as such a scenario opens up many other possibilities that can contribute to the occurrence of such a problem, which will naturally require more trial and error to solve.