A headless raspberry pi is a raspberry pi that is not hooked up to a monitor, a keyboard, or a mouse. It is pretty easy to set a raspberry pi up and then remove the peripherals, but this guide is for those who do not want to take their setups apart to set up their raspberry pi.
Things you will need
- A Raspberry Pi. They should sell as low as $35 on some websites, but if you need it quickly, it will be in stock at amazon. Make sure to have a Micro-USB cable and USB power adapter handy as well.
- An SD Card. I recommend getting a Class 10 SD Card for the fastest speeds. The small ones go for as little as 5 dollars.
- SSH. If you are using Windows, I recommend using PuTTy. You can also SSH using apps on your smartphone or tablet.
- A VNC viewer/client. I recommend TightVNC for your PC. You can also find VNC clients for your smartphone or tablet
- Ethernet connection.
- (optional) WiFi adapter. I bought the Edimax Wireless Nano USB Adapter and have had no issues.
First, download Raspbian, the primary operating system for the Raspberry Pi, and write it to the SD card. If you are using Windows, use Win32DiskImager. After the image is written to your SD card, pop it into your Raspberry Pi
Connect your Raspberry Pi to Ethernet, and power it up. Meanwhile, log in to your WiFi router to find all of the clients connected to it.
You should be able to find your raspberry pi’s local IP address
Logging into your pi
Now, ssh into your Raspberry Pi, in port 22. The default login is:
I suggest you first change your password and set up your pi by typing
sudo raspi-config Then, update your raspberry pi by
sudo apt-get upgrade.
Accessing your Desktop Environment
If you do not need to ever use a desktop environment, you are done! Otherwise, read on.
The next thing we need to do is install a VNC server. VNC stands for “Virtual Network Computing”, and allows you to view your computer screen remotely. Type the command:
sudo apt-get install tightvncserver
Now we have a VNC server installed!
I prefer to leave VNC off until I need it, so that the Raspberry Pi doesn’t maintain a desktop environment unless I need it, saving processing power. When I need to view the desktop, I type this command in ssh:
tightvncserver -geometry 1366×768 (change the resolution as desired)
This will create a server, usually on port 1. It may ask you for a password on the first time, it must be less than 8 characters.
Then, just log into your VNC viewer and put in your server details and login credentials.
If you want to close the VNC server, type
tightvncserver -kill :[port] (where [port] is most likely 1)
Now you have your headless raspberry pi set up!
Adding WiFi (optional)
Plug your WiFi dongle into a USB port of the Raspberry Pi. On the desktop, you should see WiFi Config. If not, go to
wpa_supplicant user interface.
Click Scan and configure your network.