
One of the most useful things about Raspberry Pi is that you do not always need a monitor, keyboard, or mouse to use it. Raspberry Pi’s official documentation explicitly supports headless setup, meaning you can preconfigure your device with a hostname, user account, network connection, and SSH access before the first boot.
That makes Raspberry Pi perfect for servers, automation projects, remote devices, and clean minimalist builds where you do not want extra peripherals attached.
In this guide, you will learn how to set up your Raspberry Pi without a monitor, using the current official Raspberry Pi Imager workflow and SSH for remote access. This is the easiest method for most beginners.
What Is a Headless Raspberry Pi Setup?
A headless setup means your Raspberry Pi runs without a directly connected display, keyboard, or mouse. Instead, you access it remotely over your network. Raspberry Pi’s documentation describes a headless computer as one that is accessible only over the network, and it recommends preconfiguring networking and SSH during operating system installation.
In practical terms, that means:
-
you prepare the microSD card on another computer
-
you configure Wi-Fi, username, password, and SSH before first boot
-
you power on the Raspberry Pi
-
you connect to it remotely from your laptop or desktop
This is especially useful for Pi-hole, home servers, automation systems, and always-on Raspberry Pi projects.
Why Use a Headless Setup?
A headless Raspberry Pi setup is useful because it saves space, reduces clutter, and makes remote management much easier. Raspberry Pi’s documentation positions remote access through SSH and Raspberry Pi Connect as standard parts of the platform’s workflow.
A headless setup is ideal if you want to:
-
use Raspberry Pi as a server
-
place it somewhere without a display
-
control it from your main computer
-
avoid buying extra peripherals
-
build a clean permanent project
For many users, once they try headless Raspberry Pi once, they prefer it for most non-desktop projects.
What You Need for a Headless Raspberry Pi Setup
Before you start, you need:
-
a Raspberry Pi
-
a microSD card or other supported boot storage
-
a computer to prepare the operating system
-
Raspberry Pi Imager
-
a power supply for your Pi
-
a Wi-Fi or Ethernet network
-
an SSH client on your main computer
Raspberry Pi’s getting started documentation says you can set up your Raspberry Pi headless by preconfiguring the hostname, user account, network connection, and SSH when you install the operating system.
Step 1: Download Raspberry Pi Imager
The easiest official way to prepare a headless Raspberry Pi is with Raspberry Pi Imager. Raspberry Pi’s getting started guide uses Imager as the standard setup tool, and the newer Imager 2.0 release emphasizes easier OS customisation options in the interface.
Install Raspberry Pi Imager on your Windows, macOS, or Linux computer before continuing. Raspberry Pi’s official software page and setup documentation position it as the main tool for writing and customizing Raspberry Pi OS images.
Step 2: Insert Your microSD Card
Insert the microSD card into your computer using an SD card reader or adapter. This card will hold Raspberry Pi OS and your startup configuration.
Be careful here: writing the operating system image will erase the contents of the selected storage device. That is an inherent part of the imaging process described in Raspberry Pi’s setup flow.
Step 3: Choose Your Device and Operating System
Open Raspberry Pi Imager and choose your Raspberry Pi model if prompted. Then choose your operating system.
For most headless setups, Raspberry Pi OS Lite is the most common choice because it does not include the desktop environment and is intended for lightweight or server-style setups. Raspberry Pi’s operating system documentation lists Raspberry Pi OS Lite as the no-desktop option, while the standard desktop versions are intended for more traditional interactive use.
If you want the option of a desktop later, you can still choose Raspberry Pi OS with desktop and run it headless at first. A headless setup refers to how you access the Pi, not necessarily which OS edition you install. That distinction follows from Raspberry Pi’s documentation describing headless access as a network-based setup method.
Step 4: Open the Customisation Options
This is the key step.
Raspberry Pi says you can preconfigure a hostname, user account, network connection, and SSH during OS installation. Imager 2.0 also highlights that OS customisation is now easier to access in the interface.
Inside the customisation settings, configure the following:
-
hostname
-
username
-
password
-
Wi-Fi SSID
-
Wi-Fi password
-
Wi-Fi country
-
locale and timezone
-
enable SSH
This is what makes first-boot headless setup so much easier than older manual methods.

Step 5: Enable SSH
SSH is what allows you to remotely access the Raspberry Pi terminal from another computer on the same network. Raspberry Pi’s remote access documentation describes SSH as the standard way to access a remote terminal and notes that you need to enable the SSH server.
When you enable SSH in Raspberry Pi Imager, your Pi will be ready for remote login as soon as it boots and joins the network.
For most beginners, password authentication is the easiest method to start with. More advanced users can later switch to key-based authentication for stronger security.
Step 6: Enter Your Wi-Fi Details
If you are not using Ethernet, enter your Wi-Fi SSID, password, and country code in the customisation menu. Raspberry Pi’s setup documentation states that you can preconfigure the network connection during installation, which is exactly what makes wireless headless setup possible.
This is one of the most important steps. If the Wi-Fi details are wrong, the Raspberry Pi may boot successfully but never appear on your network.
Also note that some Raspberry Pi boards or wireless adapters may not support every 5GHz network scenario, so if wireless setup fails, your network configuration is one of the first things to check. Raspberry Pi’s configuration documentation explicitly notes that some boards and adapters do not support 5GHz Wi-Fi.
Step 7: Set Username, Password, and Hostname
Modern Raspberry Pi OS setup expects you to define a username and password during installation rather than relying on older defaults. Raspberry Pi’s headless setup flow explicitly mentions preconfiguring a user account and hostname in Imager.
Choose:
-
a simple hostname, such as
raspberrypiorraspitips-pi -
a secure username
-
a strong password
The hostname matters because you may be able to connect using that name instead of hunting for the numeric IP address.
Step 8: Write the Image to the Card
Once everything is configured, write the image to the microSD card. Raspberry Pi Imager will prepare the card with both the operating system and your custom settings. Raspberry Pi describes this as the process of installing an OS while preconfiguring the system for headless use.
After the write completes, safely eject the card from your computer.
Step 9: Boot the Raspberry Pi
Insert the card into your Raspberry Pi, connect it to power, and let it boot.
If you are using Ethernet, connect the cable before power-on. If you configured Wi-Fi correctly in Imager, the Pi should connect to your wireless network automatically during first boot. Raspberry Pi’s documentation describes this preconfigured network behavior as part of the headless installation flow.
Give it a few minutes on first boot, because the OS may still be completing initial setup tasks.
Step 10: Find Your Raspberry Pi on the Network
Now you need a way to connect to the Pi from your main computer.
In many home networks, you can try connecting with the hostname you assigned, such as:
-
hostname.localon many local networks -
or directly by the device’s IP address
Raspberry Pi’s remote access documentation includes guidance on finding the IP address of your Raspberry Pi and then connecting with SSH.
Common ways to find it include:
-
checking your router’s connected devices list
-
using a network scanner app
-
using the hostname you set in Imager
Step 11: Connect Over SSH
Once you know the hostname or IP address, connect using SSH.
Raspberry Pi’s remote access documentation states that you can access the terminal of a Raspberry Pi remotely from another computer on the same network using the Secure Shell protocol.
Typical connection examples look like this:
or
On Windows, many users use PowerShell or tools like PuTTY. On macOS and Linux, SSH is usually built into the terminal. The fact that SSH is the supported remote-terminal path comes directly from Raspberry Pi’s official remote access guidance.
When prompted, enter the password you configured in Raspberry Pi Imager.
Step 12: Update and Configure the Pi
Once logged in, update the system and continue with your project setup. Raspberry Pi’s documentation includes OS and configuration guidance after initial installation, and SSH is one of the standard ways to perform that configuration remotely.
At this point, your monitor-free Raspberry Pi is fully usable.
You can now:
-
install packages
-
run updates
-
configure services
-
start server software
-
manage files
-
continue with automation or project work
Optional: Use Raspberry Pi Connect or VNC Later
If you eventually want more than terminal access, Raspberry Pi also documents Raspberry Pi Connect as a remote access option, alongside SSH and VNC-related remote workflows.
That means a headless Pi does not have to stay command-line only forever. You can begin with SSH and later add richer remote access methods depending on your project.
Common Headless Setup Problems
Most headless Raspberry Pi setup failures come from a few predictable causes:
-
wrong Wi-Fi name or password
-
SSH not enabled
-
not waiting long enough on first boot
-
using the wrong hostname
-
looking on the wrong network
-
power supply issues
-
unsupported Wi-Fi band or regional mismatch
Raspberry Pi’s documentation supports several of these checks directly: SSH must be enabled, network settings can be preconfigured in Imager, and some wireless hardware does not support all 5GHz scenarios.
If wireless setup keeps failing, Ethernet is often the fastest troubleshooting path because it removes Wi-Fi configuration from the equation. That is a practical inference from the official headless workflow.
Is Headless Setup Good for Beginners?
Yes. In fact, it is often the cleanest way to learn how Raspberry Pi works as a server or network device.
Raspberry Pi’s official documentation treats headless setup as a normal first-class setup path, not a niche workaround. You can preconfigure your system, boot it, and manage it entirely over the network.
For beginners interested in:
-
Pi-hole
-
home servers
-
automation
-
Docker
-
network tools
-
remote projects
headless setup is one of the most valuable skills to learn early.
Final Thoughts
Setting up your Raspberry Pi without a monitor is much easier than it used to be. Raspberry Pi’s official setup process now allows you to preconfigure hostname, credentials, Wi-Fi, and SSH directly in Raspberry Pi Imager, which makes first-boot headless setup straightforward for most users.
The simple formula is this:
prepare the card, enable SSH, enter your network settings, boot the Pi, and connect remotely.
Once you do it once, you will probably use headless Raspberry Pi setups far more often.



