Legend:

The following installation instructions are meant to be executed on the raspi. After writing the image to the SD card plug the card into the raspi and connect it to Ethernet and power. The raspi will automatically get an IP address via DHCP if such service is provided. All the following instructions assume that you have found a way to know the IP (query the router/DHCP server or guess) and logged in as root using {{{ssh root@the-ip-you-found}}}. The initial password is {{{raspberrypi}}}.

13

14

=== First Boot Setup ===

15

If you plug a screen, keyboard, and mouse, or if you connect using VNC to the first boot screen you can do several of the steps mentioned later over the graphical first time setup guide, i.e. resizing the root file system, setting up the time zone, or configuring the graphical output. Confer the setting up VNC below to use the VNC method. If you choose to use the graphical setup you can skip the following manual steps.

16

17

=== Installing a VNC Server ===

18

There are two methods to setup the VNC server. First, you can run a VNC server manually each time you want to use it. This method is required to connect to the first boot screen. The second method adds a module loaded by the X server so that VNC is enabled each time the graphical screen starts.

19

20

For either method first install the required packages using

21

{{{

22

yum install tigervnc-server tigervnc-server-module

23

}}}

24

25

==== Manual VNC Server ====

26

Login as root. Check which display the X server is using by issuing

27

{{{

28

ps ax | grep Xorg

29

}}}

30

You will get a line where the commands starts with something like {{{/usr/bin/Xorg :0}}}. The ":0" shows you the display number. For first boot it will most likely be ":9". Then create a password and run the VNC server with

31

{{{

32

# vncpasswd /etc/vnc-passwd

33

Password: ...

34

Verify: ...

35

# DISPLAY=:0 x0vncserver -PasswordFile /etc/vnc-passwd

36

}}}

37

As you can see the display number must be adjusted as needed.

38

39

==== Automatic VNC Server integrated in X Server ====

40

First setup the password file as described above in the manual section. Then create the file {{{/etc/X11/xorg.conf.d/30-vncserver.conf}}} with the following content.

41

{{{

42

Section "Screen"

43

Identifier "VNC"

44

Option "SecurityTypes" "VncAuth"

45

Option "UserPasswdVerifier" "VncAuth"

46

Option "PasswordFile" "/etc/vnc-passwd"

47

EndSection

48

49

Section "Module"

50

Load "vnc"

51

EndSection

52

}}}

53

The VNC server will be active after the next restart of the X server. In doubt just reboot. Do this only after first boot has been completed initially.