VNC Server on Raspberry Pi with Autostart

The Raspberry Pi is a versatile mini computer: as such I can use it with USB keyboard, mouse and HDMI LCD monitor. But having multiple keyboards and mouse on my desktop is not my thing: somehow I always grab the wrong one. So what I prefer is to run the Raspberry with VNC (Virtual Network Computing). That way I have the Linux GUI as a window on my normal desktop, and no messing up with keyboards and mouse 🙂 :

Raspberry Pi on my Dekstop

Raspberry Pi on my Dekstop

VNC is a graphical desktop sharing. It requires a software installed on the Linux machine as a server, and as viewer running on the other client machine (e.g. Windows) which then connects over the network to the server. That way the input devices and displays of the client machine can be used as if they are attached to the server.


In my setup, the Raspberry Pi is booting to the desktop environment by default.

Installation of VNC on the Raspberry Pi is described in To start the server on the Raspberry, use

vncserver started

vncserver started

On my laptop I’m using the free VNC Viewer from RealVNC (

VNC Viewer

VNC Viewer


In the client connection settings, I specify the IP address plus the screen number (:1):

VNC Client Connection Settings

VNC Client Connection Settings

💡 I had problems connecting the client and the server if they were not in the same subnetwork. I did not investigate this further, but I believe it is about which ports are open on the network router. From a security point of view I’m OK with this.

The address to connect to is shown in the VNC Server:

VNC Server with Address

VNC Server with Address


Now when the Raspberry Pi gets rebooted, I have to restart the server manually. Here is how to get it started automatically:

Change the director to the user (pi, usually /home/pi/) account directory:

cd ~

In that folder, there shall be a .config directory, change to that one:

cd .config

If it not already exists, create a directory named ‘autostart’:

mkdir autostart
autostart in config

autostart in config

Change to that directory:

cd autostart

In that folder create (if it does not already exist) a file named tightnc.desktop. It can be created/edited with

nano tightvnc.desktop

Then add the following:

[Desktop Entry]
Exec=vncserver :1
Editing tightvnc.desktop

Editing tightvnc.desktop

Save the content with CTRL-O and then exit with CTRL-X.

That’s it: reboot Linux and the VNC server will be running automatically.


Virtual Network Connection (VNC) with a VNC viewer is a good way to avoid too many input and output devices on a workbench: it allows me to use my desktop display, mouse and keyboard to use it for the Raspberry Pi. All what it requires is a viewer on the desktop and a the VNC server running on the Linux machine. To autostart the VNC server, a file tightvnc.desktop has to be created.

Happy VNCing 🙂


6 thoughts on “VNC Server on Raspberry Pi with Autostart

  1. Great tip. I set the Exec entry to

    Exec=vncserver :1 -geometry 1600×900 -depth 24

    … to enable a little larger display than what I was getting for the default.


What do you think?

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.