Headless Raspberry Pi Configuration Guide

Setting up a Raspberry Pi “headless”—without a monitor, keyboard, or mouse—allows you to get your device up and running using only a network connection and another computer. This guide covers the essential steps to configure a Raspberry Pi completely from scratch, including flashing the operating system, pre-configuring Wi-Fi and SSH access, and finding the device’s IP address on your local network to establish a remote connection.

Preparing the MicroSD Card

The easiest way to configure a headless Raspberry Pi is by using the official Raspberry Pi Imager software on your primary computer. This tool allows you to write the operating system to your MicroSD card while simultaneously injecting your network and access settings.

Insert your MicroSD card into your computer and launch the Raspberry Pi Imager.
Click Choose Device and select your specific Raspberry Pi model.
Click Choose OS and select the recommended Raspberry Pi OS (64-bit) or a Lite version if you do not need a desktop environment.
Click Choose Storage and select your MicroSD card.

Configuring OS Customization Settings

Before writing the OS to the card, you must open the Advanced Options menu to configure the headless settings. In newer versions of the Imager, a prompt will appear asking if you would like to apply OS customization settings after you click “Next”.

Enabling SSH

To control your Raspberry Pi remotely, you must enable the Secure Shell (SSH) protocol. In the customization menu, check the box for Enable SSH and select Use password authentication.

Setting the Username and Password

By default, recent versions of Raspberry Pi OS do not have a default username and password for security reasons. You must define them here. Create a custom username (e.g., pi) and a strong, memorable password.

Configuring Wi-Fi

If you are not connecting the Raspberry Pi directly to your router via an Ethernet cable, you must provide your wireless network credentials.

Check the box for Configure wireless LAN.
Enter your Wi-Fi network’s exact SSID (name) and Password.
Set the Wireless LAN country code to your local region (e.g., US, GB, CA) to ensure the Wi-Fi hardware complies with local laws.

Once these settings are filled out, save the customization profile and click Write. Wait for the process to complete and verify the card.

Booting the Raspberry Pi

Once the flashing process is complete, eject the MicroSD card from your computer and insert it into the Raspberry Pi.

Connect an Ethernet cable if you opted out of the Wi-Fi configuration.
Plug in the power supply to turn on the Raspberry Pi.
Wait approximately 1 to 2 minutes for the first boot sequence to complete, during which the Pi will automatically configure the file system and connect to your local network.

Finding the Raspberry Pi IP Address

To connect to the Raspberry Pi, you need to know its IP address on your local network. You can discover this using a few different methods:

mDNS / Hostname: By default, the Raspberry Pi broadcasts itself as raspberrypi.local. You can often use this address directly instead of a numerical IP.
Network Scanner: Download a network scanning tool like Fing on your mobile device, or Angry IP Scanner on your computer, to scan your local network for a device manufactured by “Raspberry Pi Foundation”.
Router Admin Page: Log into your home router’s web interface and look at the list of connected DHCP clients to find the IP address assigned to your Pi.

Connecting via SSH

With the IP address in hand, you can now connect to your Raspberry Pi using a command-line interface from your main computer.

On Windows, Mac, or Linux: Open the Terminal (or PowerShell/Command Prompt on Windows) and type the following command, replacing username with the username you created and IP_ADDRESS with your Pi’s actual IP address or raspberrypi.local:

ssh username@IP_ADDRESS

Authentication: Press Enter, type yes to accept the security fingerprint warning, and then type the password you configured in the Raspberry Pi Imager.

Once logged in, you will have full command-line access to your Raspberry Pi system without ever having attached a physical monitor.