vncpasswd - Man Page

change the VNC password

Synopsis

vncpasswd [passwd-file]
vncpasswd -f

Description

vncpasswd allows you to set the password used to access VNC desktops.  Its default behavior is to prompt for a VNC password and then store an obfuscated version of this password to passwd-file (or to $XDG_CONFIG_HOME/tigervnc/passwd if no passwordfile is specified.)  The vncserver script runs vncpasswd the first time you start a VNC desktop, and it invokes Xvnc with the appropriate -rfbauth option. vncviewer can also be given a password file to use via the -passwd option.

The password must be at least six characters long (unless the -f command-line option is used-- see below), and only the first eight characters are significant.  Note that the stored password is not encrypted securely - anyone who has access to this file can trivially find out the plain-text password, so vncpasswd always sets appropriate permissions (read and write only by the owner.)  However, when accessing a VNC desktop, a challenge-response mechanism is used over the wire making it hard for anyone to crack the password simply by snooping on the network.

Options

-f

Filter mode.  Read a plain-text password from stdin and write an encrypted version to stdout.  Note that in filter mode, short or even empty passwords will be silently accepted.

A view-only password must be separated from the normal password by a newline character.

Files

$XDG_CONFIG_HOME/tigervnc/passwd
$HOME/.config/tigervnc/passwd

Default location of the VNC password file.

See Also

vncviewer(1), Xvnc(1) vncconfig(1), vncsession(8)
https://www.tigervnc.org

Authors

Tristan Richardson, RealVNC Ltd., Antoine Martin, D. R. Commander and others.

VNC was originally developed by the RealVNC team while at Olivetti Research Ltd / AT&T Laboratories Cambridge.  TightVNC additions were implemented by Constantin Kaplinsky. Many other people have since participated in development, testing and support. This manual is part of the TigerVNC software suite.

Referenced By

vncconfig(1), vncsession(8), vncviewer(1), x0vncserver(1), x11vnc(1), Xvnc(1).

TigerVNC Virtual Network Computing