===== Headless installation =====

**Normal wired network headless installation**

If you would like to use Berryboot without having a display attached, open the file named **cmdline.txt** located on the SD card in a text editor, and append the following settings to the same line as the other options:

<code>
vncinstall ipv4=192.168.88.88/255.255.255.0/192.168.88.1 
</code>

The network information is in IP/netmask/gateway format.\\ 
You can then start a [[http://en.wikipedia.org/wiki/Vnc|VNC]] client program on your normal computer, and connect to the IP-address you specified.

**Wireless headless installation**

To start a headless installation using wifi, append to **cmdline.txt** on the same line as the existing options:

<code>
vncinstall ipv4=192.168.88.88/255.255.255.0/192.168.88.1/wlan0
</code>

And create a file called **wpa_supplicant.conf** on the FAT partition of the SD card with the wifi SSID and password in the following format:

<code>
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
ap_scan=1


network={
    ssid="ssid-of-accesspoint"
    psk="wpa-password"
}
</code>

**Known issues**

The VNC client you are using must request 24-bit color (*not* 256 colors palleted mode).
TightVNC and krdc work fine by default, for RealVNC make sure you enable FullColour in the settings:

{{ :berryboot:realvnc_settings.png |}}

Using a VNC client that requests the wrong amount of colors, will crash the application (displaying an "emergency recovery shell" on screen).

===== See also =====

  * [[:berryboot|Main Berryboot page]]