How to Login into OctoPi (octopi.local)? (& Fix Incorrect Login Issues)

OctoPi is one of the best ways to manage your 3D printer as it allows you to have complete control over everything your 3D printer can offer entirely remotely.

While its interface is quite user-friendly, there is a slight learning curve to setting it up for the first time and logging in if you aren’t too familiar with Linux and Raspberry Pi in general.

A common issue many OctoPi users face is not being able to login into the interface after setting it all up, which can be quite frustrating after going through the steps to set it all up.

So, how to login into OctoPi?

Here are the steps you should follow to login into OctoPi:

1. Ensure that the Raspberry Pi and the computer you’re trying to access OctoPi (octopi.local) from are on the same network.
2. Find the local IP of the Raspberry Pi through the router interface.
3. Type the IP you have found into the address bar of your browser and navigate to it.
4. Login into OctoPi with the username password you have set during the initialization process.

Moving on, we will be going into more detail about logging into OctoPi, what you should do to fix the “login incorrect” issue, the possible default login combinations, resetting your OctoPi password, and more.

How to Login into OctoPi (octopi.local)?

Logging into OctoPi is a simple task when everything is in order, but it can be a real headache if there is an issue.

First, let’s start by taking a detailed look into the steps you should take to login into OctoPi.

1. Check if the Raspberry Pi and the device you’re using to login into OctoPi are on the same network. We recommend logging into the interface of your router and finding both devices in the list of connected devices. By default, the hostname of the Raspberry Pi should be octopi or raspberrypi.
2. Find the local IP of your Raspberry Pi. As the octopi.local address does not work in some cases; it’s not the most reliable way of logging into OctoPi. We recommend finding the local IP address of your Raspberry Pi through the router interface instead.
3. Type the IP into the browser and navigate. Ensure that you do not add HTTP:// or HTTPS:// when you’re typing the IP in this step, as doing so can prevent you from connecting to the OctoPi interface.
4. Input the username-password combination into the OctoPi interface. This username-password combination is the one you set when you initialize OctoPi for the first time.

In most cases, following these steps should allow you to login into OctoPi without issues.

OctoPi Login Incorrect / Not Working – What to Do?

A common issue many users encounter with OctoPi is the dreaded Incorrect username or password message.

Here are the things we recommend trying if you have encountered this issue:

1. Ensure that you’re typing the username-password combination correctly. Things such as Caps Lock being on or a different keyboard layout being active can easily cause you to make typos in the username or the password. We recommend typing the password to an area (such as NotePad) where you can see it and copy it to the OctoPi interface.
2. Reset your OctoPi password. You can always reset your OctoPi password by SSHing into the Raspberry Pi with the default admin credentials; pi for username and raspberry for password. We will go into the process of resetting the OctoPi password in a later section for those who aren’t familiar.
3. Ensure that you have the correct username. If you can’t log in even after resetting the password, your username may be wrong. You can find out your username by SSHing into the Raspberry Pi, which we will also go into greater detail about in a later section.

How to Reset Forgotten OctoPi Password?

Resetting a forgotten OctoPi password is a straightforward task you can perform in two different ways.

Here are the steps for resetting a forgotten OctoPi password with a command (Requires OctoPrint 1.3.12+).

1. SSH into the Raspberry Pi. We will be covering it in detail in a later section for those who don’t know how to.
2. Use the command octoprint user password <user>.Example -> octoprint user password jack, where jack is the username of the account that you will be resetting.
3. You will be asked for a new password. Enter your desired new password and press Enter.
4. Restart OctoPrint server. Use the command sudo service octoprint restart to do so.

After this, you should be able to log in to the interface with the new password.

Here are the steps for resetting a forgotten OctoPi password by modifying configuration files.

Note that following this method will delete all the users on OctoPi, meaning that you will need to restore the other users (if any) manually by backing up the users.yaml file first.

1. SSH into the Raspberry Pi. We will be covering it in detail in a later section for those who don’t know how to.
2. Remove the user config file. Use the command sudo rm ~/.octoprint/users.yaml to do so.
3. Modify the main config file. Use the command sudo sed -i -e ‘s/firstRun: false/firstRun: true/g’ ~/.octoprint/config.yaml to do so.
4. Restart OctoPrint server. Use the command sudo service octoprint restart to do so.

When you connect to the OctoPi interface the next time, you will be prompted with the initialization interface where you can set a new user up with a fresh password.

Forgot OctoPi Username – What to Do?

If you forgot your OctoPi username, the only way to recover it is by SSHing into the Raspberry Pi.

Here are the steps for retrieving forgotten OctoPi usernames:

1. SSH into the Raspberry Pi. We will be covering it in detail in a later section for those who don’t know how to.
2. Print the contents of the user OctoPrint config file. Use the command sudo cat ~/.octoprint/users.yaml to do so.

You should be able to find your username in this file, as it stores all the user data for OctoPi, including the usernames of other users, if there are any.

How to Change OctoPi Username?

The easiest way to change your OctoPi username is to create a new user with admin permissions through the OctoPi interface.

Here are the steps:

1. Go to Settings > Access Control.
2. Click the Create new user button.
3. Choose the admin privilege level.
4. Input the username you want to use and a password of your choice.

From now on, use this new user to login into OctoPi, which will effectively mean that you have changed your username.

If you wish to, you can also remove your old username from the system.

How to SSH into OctoPi?

SSHing into OctoPi is no big deal, even if you have no prior experience with it.

Here is how you can easily SSH into OctoPi:

1. Find the local IP of your Raspberry Pi. You can find this information in your router’s interface. The default hostname for the Raspberry Pi should be octopi or raspberrypi.
2. SSH into the Raspberry Pi with the default login. Use the command ssh pi@<ip_address>. Example -> ssh [email protected]. Windows users can use PuTTY or WSL.
3. Type the default password when prompted. The default password for SSHing into a Raspberry Pi is raspberry.

Congratulations, you have successfully connected to the Raspberry Pi with SSH!

Default SSH Login (admin) Information for OctoPi

If you haven’t modified the admin user’s credentials, the default SSH login combination for OctoPi should be the same as any other Raspberry Pi.

Here are the default admin credentials for SSHing into OctoPi:

Username: pi

Password: raspberry

Please note that the username-password combination for SSH is NOT the same as the username-password combination you use for logging into the OctoPi interface.

Wrapping Up

As the issue of not being able to login into OctoPi is usually a result of simple factors such as not using the correct IP address or not knowing the default username and password, solving the problem is straightforward once you have the accurate information.

We hope that this article has been helpful for you to solve your OctoPi login issues in the quickest and easiest way possible.

Stay tuned for more detailed solutions to common 3D printing issues in the future!

Mike Davies

Mike started his 3D printing journey with the Anet A8 when it first came out back in 2017, and has been obsessed with 3D printers ever since. Nowadays, he primarily uses his Ender 3 to print functional parts that make his life more convenient whenever possible.