You have probably already noticed that after the system installation, all Raspberry Pi on Raspberry Pi OS have the same name.
In this post, I will explain to you what it is and how to change it as you want.
The easiest way to set the hostname for a new installation, is to use the advanced options in Raspberry Pi Imager and fill the first field with the desired hostname. After the installation, using the configuration tool in a terminal allow you to change it too (sudo raspi-config).
That’s it for the short answer, I will now give you all the details and introduce other solutions.
I will also start with a quick reminder about the hostname in general, if you are not (yet) used to this term.
By the way, if you are just getting started on Raspberry Pi, I can help you learn much faster. My Raspberry Pi bootcamp course helps you step-by-step to discover the Raspberry Pi device and unlock its secrets. In a few hours, you’ll be ready to start any awesome project you are interested in.
Host name introduction on Raspberry Pi
What is a hostname?
On a network, devices will use a few identifiers, like the IP address or MAC address.
They also have a label, mainly to help us to identify which device has which IP (the hostname).
For example, when you do a network scan (as explained here), it will generally give you the IP and MAC address but also a name (the hostname):
You can choose what you want as a hostname, but you need to avoid using the same hostname on several devices.
Valid hostnames are between 1 and 63 characters, with only letters (a-z), digits (0-9) and hyphens (-).
What is the default value?
On Raspberry Pi, the default value is “raspberrypi”.
You can check that with the following command:
Any fresh new Raspberry Pi OS installation will get this default hostname, even if you already have another Raspberry Pi on your network.
Even if it’s not mandatory, it’s a good practice to change it after the installation (I’ll show you how to do this in the next section).
Are you a bit lost in the Linux command line? Check this article first, for the most important commands to remember, and a free downloadable cheat sheet so you can have the commands at your fingertips.
How to change the hostname on Raspberry Pi
Let’s look at how to change the default hostname to a custom name.
I will show you four different ways to do this now.
Solution 1: Use Raspberry Pi imager
If you use Raspberry Pi Imager to install a new system (especially for Raspberry Pi OS), you can now use the OS Customization options to set the new hostname directly. It will save the name you choose on the sd card, and use it instead of the default value on the first boot.
- Start Raspberry Pi Imager.
- Select the Raspberry Pi OS version you want to install.
- Pick the media where you’ll install your system.
- When you click on “Next” to start the installation, the tool will ask if you want to apply OS customization settings or not.
Click on “Edit Settings” to get this pop-up:
- From there, you can check the “Set hostname” box and change the default value:
- Then, click on “Save” and start the flashing process as usual (click on “Yes” to apply these settings).
The hostname will be set as requested on the first boot.
Just remember to change it if you have several Raspberry Pi, as it will use it every time you flash a new SD card.
The only issue with this solution, is that it works on Raspberry Pi OS, should work with other Debian-based distributions (not all the time) and won’t work on custom images and other systems. So, check the following solutions if you are not using Raspberry Pi OS.
If you are not used to this tool, I have a complete guide for Raspberry Pi Imager here. Please don’t hesitate to check it before going further.
Solution 2: Edit the configuration file
Open and edit the /etc/hostname file
This solution is great because it works on almost any Linux distribution.
There is a file on most systems with the device hostname inside.
On Raspberry Pi OS (and any Linux system, I think), this file is /etc/hostname.
Here is how to change it:
- Open the file with nano:
sudo nano /etc/hostname
- A file opens that only contains the default hostname: “raspberrypi”.
- Remove the word and replace it with the one you want, for example:
- Save the file and exit (CTRL+O, CTRL+X).
- If you use the hostname command now, the value will still be the same.
You need to reboot the Raspberry Pi to apply changes:
- Once restarted, the new hostname will appear in the command prompt.
And, you can also check with the
If you have some issues (or warnings at least) with some network services, you probably need to edit the /etc/hosts file to update the localhost name:
- Open the /etc/hosts file the same way:
sudo nano /etc/hosts
- Edit the last line to update the Raspberry Pi name.
- Save and exit (CTRL+O, CTRL+X).
You can use the same method on systems like Debian and Ubuntu.
Solution 3: Use raspi-config
The next two solutions are only available on Raspberry Pi OS.
It can be easier if you can’t remember the filename to edit, or are not comfortable with a terminal, especially with editing files.
You can also check the last one if you are on Raspberry Pi OS with Desktop.
The solution is to use raspi-config.
You probably already know this tool, as you can use it to change many things in your Raspberry Pi configuration.
Here is how to change the hostname in raspi-config:
- Start raspi-config with:
- On the wizard that shows up, click on “System options” (just press Enter).
Note: if you are using an old version of Raspberry Pi OS, the hostname option might be under “Network options” instead of “System options”.
- Then click on “Hostname” (press enter).
Use the arrows to select the corresponding line and press enter to confirm.
- You’ll get a message about the letters you can use (a-z, 0-9 and -).
- Confirm (Enter) and type your new hostname.
- After the confirmation, you will be back on the main menu.
- Select the Finish option to save your changes (use Tab and press Enter).
- Raspi-config will ask you to reboot.
Confirm and wait a few seconds.
- Once the system reboot is complete, you can see the new hostname in the command prompt:
Same thing with the “hostname” command.
Note: you may also need to follow the “Network update” from the last part if you have errors like this:
sudo: unable to resolve host <hostname>: No address associated with hostname
Solution 4: Use the configuration tool on Raspberry Pi OS Desktop
The last option I want to show you is to use the Raspberry Pi Configuration Tool on Raspberry Pi OS Desktop.
This is probably the easiest method if you are on this Raspberry Pi OS version.
Here is how to do this:
- In the main menu, go to Preferences > Raspberry Pi Configuration.
- In the configuration tool, click on “Change Hostname” and update the field:
- Click “OK” to save the changes.
- And as with the other solutions, a reboot is needed to apply changes.
Click on “Yes” to immediately reboot.
Note: In this case, there is no need to update the /etc/hosts file. The wizard will change it for you.
Want to chat with other Raspberry Pi enthusiasts? Join the community, share your current projects and ask for help directly in the forums.
That’s it, you now know 4 ways to change the Raspberry Pi name, whatever the Raspberry Pi OS version you use.
I hope this post was useful for you.
If you have any remaining question or a suggestion, feel free to leave a comment in the community.
By the way, here are a few posts that might help you to customize your system after installation:
- Create new users on your Raspberry Pi
- Change the default style and theme on Raspberry Pi OS
- Remove useless apps and free some disk space after installation
Whenever you’re ready, here are other ways I can help you:
The RaspberryTips Community: If you want to hang out with me and other Raspberry Pi fans, you can join the community. I share exclusive tutorials and behind-the-scenes content there. Premium members can also visit the website without ads.
Master your Raspberry Pi in 30 days: If you are looking for the best tips to become an expert on Raspberry Pi, this book is for you. Learn useful Linux skills and practice multiple projects with step-by-step guides.
The Raspberry Pi Bootcamp: Understand everything about the Raspberry Pi, stop searching for help all the time, and finally enjoy completing your projects.
Master Python on Raspberry Pi: Create, understand, and improve any Python script for your Raspberry Pi. Learn the essentials step-by-step without losing time understanding useless concepts.
You can also find all my recommendations for tools and hardware on this page.