Connecting with VNC

To control your pi-top [4] via another computer such as a MacBook, PC or Chromebook, you need to use VNC (virtual network computing).

VNC is a nifty little tool that allows you to control your pi-top[4] from another computer. Unlike SSH, VNC allows access to the entire OS. This means that you can create programs and play with your hardware from your regular computer.

Step 1

Firstly, you'll need to download RealVNC.

Download Real VNC:uploaded

Step 2

Next, we will need to connect our pi-top [4] with your device and find your IP address which is needed to connect to VNC. There are a few methods to choose from. The first method is by using a pi-top Display Cable. The second method uses the Ethernet port of your pi-top [4] or over WiFi if both devices are on the same WiFi Network.

Method 1: Display Cable

You'll have to connect the pi-top Display Cable to the Display Port on the pi-top[4] and attach the USB Adapter onto the Display Cable and plug that into your machine. This allows your computer to connect to the USB On-The-Go port of the Raspberry Pi 4. You should see the USB Device appear on your computer as RNDIS/Ethernet Gadget. 

USB OTG IP Address:

Method 2: WiFi

To do this step over WiFi, first make sure that both your pi-top [4] and your device have been connected to the same WiFi network.

To connect your pi-top [4] to the internet for the first time, you will need to have connected your pi-top [4] to a display screen already in order to log in to your network.

Now you just need to through the menu items of your pi-top [4] OLED minicreen until you see the IP Address off of your pi-top [4].

To find your IP address on your pi-top [4], press the arrow keys by the OLED miniscreen until you find the WiFi symbol and your IP address will be displayed. You can also hover over the WiFi icon along the taskbar in the bottom right if you have a display connected to your pi-top [4].

Method 3: Ethernet

To connect through a wired connection, first plug in your ethernet cable into the ethernet port of your pi-top [4]. Next, you just have to scroll through your menu items on your pi-top [4] OLED miniscreen and find your IP address.

To find your IP address on your pi-top [4], press the arrow keys by the OLED miniscreen until you find the IP address.

Step 3

Now you have found your IP address, open up VNC Viewer and type in your IP address.

You'll get this little window coming up to tell you to type in the username and password. The login information is:

Username:   pi

Password:   pi-top



Et voilà! You're in! You'll see some controls at the top of the window for ending the session, making the window full screen or even transferring files between your pi-top[4] and your computer! You can do literally everything you could do by being connected directly to your pi-top [4].


Please refer to our getting started guide for more information on connecting with VNC.