# Enabling VNC (Remote Desktop)

**Step 1:** On Mac OS, open a "Terminal" window. On Windows, open a "Windows PowerShell" window. Then enter, "ssh \<your\_rpi5\_username>@\<your\_robot\_hostname>". The username and hostname are the ones you set in the Raspberry Pi Imager setup screens. For example...

```sh
ssh admin@hackerbot
```

When asked if you are sure you want to continue type yes and hit the enter key

<figure><img src="/files/avDtC5RXdZhygtlOH0iu" alt=""><figcaption></figcaption></figure>

Next, when prompted, enter your password. Then hit the enter key. You are now connected to your Raspberry Pi 5 over the WiFi network.<br>

**Step 2:** Enable VNC to view desktop

```sh
sudo raspi-config
```

Now use the arrow and enter keys to go into "3 Interface Options" and then "I3 VNC". Set enabled to \<Yes>. Finally, exit out by selecting \<Finish>.<br>

Step 3: Download the open-source VNC client called "Tiger VNC" (available for MacOS, Windows, and Linux).

Using the link below make sure you download the viewer (not the server). From the file list, "vncviewer64-1.14.1.exe" is the viewer for windows and "TigerVNC-1.14.1.dmg" is the viewer for mac.

{% embed url="<https://sourceforge.net/projects/tigervnc/files/stable/1.14.1/>" %}

Step 4: Install and open Tiger VNC. You will be prompted to enter your username and password. Again, these are the name and password you set up in the Raspberry Pi Imager when writing the SD card.

\
Step 5: You should now see the desktop of your Raspberry Pi!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hackerbot-industries.gitbook.io/documentation-hackerbot-industries/enabling-vnc-remote-desktop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.