add vnc

articles/wiki/main.md

@@ -10,4 +10,5 @@
 * [Iris](/wiki/iris)
 * [Databases](/wiki/databases)
 * [Admin Tools](/wiki/admintools)
+* [VNC](/wiki/vnc)
 * ~~Unsorted~~ (See Table of Contents)

articles/wiki/vnc.md

@@ -0,0 +1,34 @@
+# VNC
+
+## Setup
+
+If you came here, you are most likely wanting to gain access to vnc. The process
+is not very difficult:
+
+1. Open your shell and type `acquirevnc`. This will
+   automatically give you a port number. **Note this down.**
+2. The script will also prompt you to give a password. Follow the on-screen
+   prompts, and note this password down, preferably in a password manager.
+3. Install a VNC client on your local machine. The client for tigervnc is
+   recommended.
+
+## Connection
+
+1. Forward the port to your local machine. To do this, run
+   `ssh -L xxxx:localhost:xxxx -f -N -C username@thunix.net` on
+   your local machine **every time** before you connect to your vnc. Replace
+   username with your username and xxxx with your port nummber.
+2. Connect to `localhost:xxxx` in your vnc client, where xxxx is your port number.
+3. Type in your password you chose earlier when prompted.
+
+## Starting VNC Server
+
+You normally should not need to start your vnc server, as the `acquirevnc`
+script starts your server for you. However, in the unlikely case of a server
+reboot or a vnc crash, all you need to do is run `startvnc` and vnc will begin
+in the background.
+
+## Support
+
+While the process is designed to be as easy as possible, it is easy to trip up.
+For help, jump in our IRC channel on irc.tilde.chat/6697 in channel #thunix.