vncserver(1)

💅 vncserver — the tightvnc manual, but make it cute

okay so bestie, you've stumbled into the vncserver(1) page from the TightVNC manual, and honestly? it's giving remote desktop royalty ✨

---

🌸 NAME 🌸

vncserver — a wrapper script that launches an X server for VNC. that's it, that's the girl 💅

---

✨ SYNOPSIS ✨

vncserver [:display] [-geometry widthxheight] [-depth depth]
[-pixelformat rgbNNN|bgrNNN] [-name desktop-name] [ -httpport int ] [
-basehttpport int ] [ -alwaysshared ] [ -nevershared ] [Xvnc-options...]

vncserver [ -clean ] -kill :display

vncserver -help

---

🦋 DESCRIPTION 🦋

vncserver is a wrapper script for Xvnc, the free X server for VNC (Virtual Network Computing). no cap 🫶

so here's the vibe: it gives you all the capabilities of a standard X server, but it does NOT connect to a display for itself. nope, not its job. instead, Xvnc creates a virtual desktop that you can view or control remotely using a VNC viewer. main character energy, honestly 👑

---

🎀 OPTIONS 🎀

bestie, listen: you can add Xvnc options at the command line, and they'll be added to the invocation of Xvnc without changes — no meddling, no editing, fr fr. the options that vncserver itself provides are these:

• :display — the display number to use. if you omit it, the next free display number gets used. it just knows 🔮
• -geometry widthxheight — sets the desktop width and height. pick your size, icon 💅
• -depth depth — sets the colour depth of the visual to provide, measured in bits per pixel. must be a value between 8 and 32. yes, must. no rogue numbers 🙈
• -pixelformat rgbNNN|bgrNNN — sets the colour format for pixels representation. the viewer can do the conversion to any other pixel format, but it is faster if the depth and pixel format of the server is the same as the equivalent values on the viewer display. efficiency queen behavior ⚡
• -name string — this specifies the name of the desktop. give her a name, she deserves one 🎀
• -clean — this option can be used in conjunction with
• -kill :display — stops the session running on the specified display. bye girl 👋
• -nevershared — never allow shared desktops. possessive much? 💀
• -alwaysshared — always allow shared desktops. sharing is caring 🫶
• -basehttpport int — the base http port to use for the java client applet (you have to install the tightvnc-java package to make this work). the real port number will be port = base + display num. do the math bestie 🧮
• -httpport int — the http port to use for the java client applet (you have to install the tightvnc-java package to make this work). yes, same package disclaimer, iykyk ✨
• -help — prints a short usage notice to stderr. it's giving helpful but also a little shy 🫣

---

🌈 EXAMPLES 🌈

okay so here's the lineup, and every single one ate:

vncserver

invokes Xvnc on the next available display and with suitable defaults. effortless 💅

vncserver :1

invokes Xvnc on display :1. specific queen ⭐

vncserver -geometry 800x600 -depth 16 :1

invokes Xvnc on display :1 with desktop size of 800x600 pixels and color depth of 16 bits per pixel. customized and thriving 🔥

vncserver -kill :1

shuts down Xvnc server on display :1. closing the tab on that era 💀

---

🍓 FILES 🍓

• /etc/tightvncserver.conf — system-wide configuration file of TightVNC Server. the mothership config 🌍
• $HOME/.vnc/tightvncserver.conf — user configuration file of TightVNC Server. its setting override system-wide configuration. your personal vibes > the group chat's vibes 👑

---

💜 SEE ALSO 💜

Xvnc(1), vncviewer(1), vncpasswd(1), vncconnect(1)

the whole friend group, go say hi 🫶

---

👑 AUTHORS 👑

Original VNC was developed in AT&T Laboratories Cambridge. TightVNC additions were implemented by Constantin Kaplinsky. Many other people participated in development, testing and support. legends only 🌟

Man page authors:

• Marcus Brinkmann <Marcus.Brinkmann@ruhr-uni-bochum.de>
• Tim Waugh <twaugh@redhat.com>
• Constantin Kaplinsky <const@tightvnc.com>

---

bestie reminder: this page is from the TightVNC manual, dated August 2006, and it's the vncserver(1) page. periodt. 💅✨🦋