Any device connected to a Local Area Network is assigned an IP address.
In order to connect to your Raspberry Pi from another machine using SSH or VNC, you need to know the Pi's IP address. This is easy if you have a display connected, and there are a number of methods for finding it remotely from another machine on the network.
Using the Pi with a display
If you boot to the command line instead of the desktop, your IP address should be shown in the last few messages before the login prompt.
Using the terminal (boot to the command line or open a Terminal window from the desktop), simply type
hostname -I which will reveal your Pi's IP address.
Using the Pi headless (without a display)
It is possible to find the IP address of your Pi without connecting to a screen using one of the following methods:
Router devices list
In a web browser navigate to your router's IP address e.g.
http://192.168.1.1, which is usually printed on a label on your router; this will take you to a control panel. Then log in using your credentials, which is usually also printed on the router or sent to you in the accompanying paperwork. Browse to the list of connected devices or similar (all routers are different), and you should see some devices you recognise. Some devices are detected as PCs, tablets, phones, printers, etc. so you should recognise some and rule them out to figure out which is your Raspberry Pi. Also note the connection type; if your Pi is connected with a wire there should be fewer devices to choose from.
raspberrypi.local with mDNS
If your device supports mDNS, you can reach your Raspberry Pi by using its hostname and the
The default hostname on a fresh Raspbian install is
raspberrypi, so by default any Raspberry Pi running Raspbian responds to:
If the Raspberry Pi is reachable,
ping will show its IP address:
PING raspberrypi.local (192.168.1.131): 56 data bytes 64 bytes from 192.168.1.131: icmp_seq=0 ttl=255 time=2.618 ms
If you change the system hostname of the Raspberry Pi (e.g., by editing
/etc/hostname), Avahi will also change the
.local mDNS address.
If you don't remember the hostname of the Raspberry Pi, but have a system with Avahi installed, you can browse all the hosts and services on the LAN with the
nmap command (Network Mapper) is a free and open-source tool for network discovery, available for Linux, macOS, and Windows.
To install on Linux, install the
apt-get install nmap.
- To install on macOS or Windows, see the nmap.org download page.
nmap to scan the devices on your network, you need to know the subnet you are connected to. First find your own IP address, in other words the one of the computer you're using to find your Pi's IP address:
- On Linux, type
hostname -Iinto a terminal window
- On macOS, go to
Networkand select your active network connection to view the IP address
- On Windows, go to the Control Panel, then under
Network and Sharing Center, click
View network connections, select your active network connection and click
View status of this connectionto view the IP address
Now you have the IP address of your computer, you will scan the whole subnet for other devices. For example, if your IP address is
192.168.1.5, other devices will be at addresses like
192.168.1.4, etc. The notation of this subnet range is
192.168.1.0/24 (this covers
Now use the
nmap command with the
-sn flag (ping scan) on the whole subnet range. This may take a few seconds:
nmap -sn 192.168.1.0/24
Ping scan just pings all the IP addresses to see if they respond. For each device that responds to the ping, the output shows the hostname and IP address like so:
Starting Nmap 6.40 ( http://nmap.org ) at 2014-03-10 12:46 GMT Nmap scan report for hpprinter (192.168.1.2) Host is up (0.00044s latency). Nmap scan report for Gordons-MBP (192.168.1.4) Host is up (0.0010s latency). Nmap scan report for ubuntu (192.168.1.5) Host is up (0.0010s latency). Nmap scan report for raspberrypi (192.168.1.8) Host is up (0.0030s latency). Nmap done: 256 IP addresses (4 hosts up) scanned in 2.41 seconds
Here you can see a device with hostname
raspberrypi has IP address
Getting the IP address of a Pi using your smartphone
Your phone and your Raspberry Pi have to be on the same network, so connect your phone to the correct wireless network.
When you open the Fing app, touch the refresh button in the upper right-hand corner of the screen. After a few seconds you will get a list with all the devices connected to your network. Scroll down to the entry with the manufacturer "Raspberry Pi". You will see the IP address in the bottom left-hand corner, and the MAC address in the bottom right-hand corner of the entry.
Also see lsleases