All articles
2 min read

Guide to Multibooting Raspberry Pi with BerryBoot

BerryBoot lets you run multiple operating systems from a single SD card on your Raspberry Pi. This guide covers standard and headless installation, and setting up a local OS repository.

BerryBoot is a bootloader and OS installer that lets your Raspberry Pi boot into multiple operating systems from a single SD card or USB drive. On startup it shows a menu where you pick which OS to load — useful for testing different distros or keeping a dedicated environment for different projects.

What You Need

  • Raspberry Pi (most models supported)
  • SD card (8GB minimum, 16GB+ recommended for multiple OSes)
  • BerryBoot image from berryterminal.com
  • Monitor + keyboard for standard setup, or a device with VNC for headless

Standard Installation

  1. Download the BerryBoot zip for your Raspberry Pi model from the official site
  2. Extract the contents directly onto a FAT32-formatted SD card (do not use dd — just extract the files)
  3. Insert the SD card into your Pi and power on
  4. The BerryBoot installer loads and walks you through selecting storage, downloading OS images, and creating your first installation

Headless Installation (No Monitor)

BerryBoot supports VNC-based headless setup — useful when you have no attached display.

Wired Network

Edit cmdline.txt on the SD card's FAT partition and append:

vncinstall ipv4=192.168.88.88/255.255.255.0/192.168.88.1

Format: IP/netmask/gateway. Boot the Pi, then connect from your computer using a VNC client at the IP you specified.

Wireless Network

For Wi-Fi headless setup, append instead:

vncinstall ipv4=192.168.88.88/255.255.255.0/192.168.88.1/wlan0

And create a wpa_supplicant.conf file on the FAT partition:

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
ap_scan=1

network={
    ssid="your-network-name"
    psk="your-wifi-password"
}

VNC color depth: Your VNC client must support 24-bit color. TightVNC and krdc work by default. For RealVNC, enable FullColour in settings. Using the wrong color depth can crash BerryBoot into an emergency shell.

Setting Up a Local OS Repository

If you want to install OS images from your local network instead of downloading from the internet:

  1. Download OS image files to a machine on your network
  2. Share the folder over Windows file sharing (SMB/CIFS)
  3. In the BerryBoot "Add OS" screen, press Network settings → Repository tab and enter:
cifs://192.168.1.x/share-name

BerryBoot attempts a guest login if no credentials are given. Connection settings are saved in berryboot.ini on the FAT partition, so you only need to configure this once.

Managing Installed OSes

From the BerryBoot menu at boot you can:

  • Edit — rename or set the default OS
  • Clone — duplicate an installation
  • Delete — remove an OS to reclaim space
  • Backup/Restore — export an OS image

Conclusion

BerryBoot is the simplest way to run multiple operating systems on a Raspberry Pi without juggling multiple SD cards. The headless VNC setup makes it practical even without a dedicated monitor. For the widest OS compatibility and most active maintenance, also consider PINN (a BerryBoot fork with broader hardware support).