doc/install_on_raspberry.md

Install YunoHost on a Raspberry Pi

Find all the ways to install YunoHost here.

Before setting up a server at home, it is recommended that you know the [possible limitations imposed by your ISP](/isp). If they are too restrictive, you might consider using a VPN to bypass them.

Pre-requisite

• An SD card: 8GB capacity (at least) and Class 10 speed rate are highly recommended (like the Transcend 300x) ;
• A power supply (either an adapter or a MicroUSB cable)
• An ethernet cable (RJ-45) to connect your Raspberry Pi to your router. (Raspberry Pi Zero users can connect the Pi using an OTG cable, Wifi dongle and following these instructions)
• The YunoHost Raspberry Pi image, available on build.yunohost.org. (Not needed if you want to manually install YunoHost on an existing Debian system.)

---

Installation using an image

1. Copy image to the SD card

2. Plug & boot

3. Connect to your server with SSH

4. Proceed to post-installation

---

Manual installation

The latest Rasbpian Jessie image requires a screen and a keyboard, as it is no longer possible to connect directly to the Raspberry through SSH. Nevertheless it is possible to re-enable SSH at boot : before starting your Raspberry, put in the boot partition of the SD card an empty file named `ssh` (without extension).

0. Install Raspbian Jessie Lite on the SD card (instructions) and connect to your Pi.

1. The root user must have a password, or the installation will fail. To change the root password:

sudo passwd root

2. Install git

sudo apt-get install git

2. Clone the Yunohost install script repository

git clone https://github.com/YunoHost/install_script /tmp/install_script

4. Execute the installation script

cd /tmp/install_script && sudo ./install_yunohost

---

If you need help during one of these steps, do not hesitate to use our support tools.