# VNC Usage

This is useful for setting up/debugging [Virtual Machines](/technologies/virtualization-stack.md) when they don't have ssh.

## Installation

You'll first want to install a VNC client on your computer—we recommend TigerVNC. To install TigerVNC on Ubuntu, run the following command:

```
sudo apt install tigervnc
```

If you are running Arch Linux, you can install it through Pacman by running the following command:

```
sudo pacman -S tigervnc
```

## Usage

Then, ssh into the machine running the virtual machine and run the following command as root:

```
virsh vncdisplay <vm_name>
```

You will get an output similar to `127.0.0.1:1` add 5900 to the last number to get the port the VNC server is listening on. In this case, the port would be 5901.

Then, use ssh tunneling to forward that port to your local computer. If you are not on the CSL network, you will need to use [Openvpn](/obsolete/openvpn.md) or tunnel twice through one of the [RAS](/services/remote-access.md)es. For example, if the virtual machine was on [Antipodes](/machines/vm-servers/antipodes.md):

```
[you@yourcomputer:~]$ ssh -L 5901:localhost:5901 ras1.tjhsst.edu
[2019yyou@ras1:~]$ ssh -L 5901:localhost:5901 antipodes.csl.tjhsst.edu
```

{% hint style="info" %}
If you are using [sshuttle](https://github.com/sshuttle/sshuttle), you can skip the tunneling through RAS since sshuttle does that for you.
{% endhint %}

Finally, open up your VNC client and connect to `127.0.0.1:<PORT>` (in this example `5901`). That's it!

Look at your VNC's manual to learn how to use it better. Mostly, though, keyboard and mouse input should pass right through as long as the VNC window is focused.

If you press Ctrl+Alt+Delete while connected via tty, you will reboot the machine, so exercise caution.


---

# 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://documentation.tjhsst.edu/guides/how-to-use-vnc.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.