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

• A Raspberry Pi 0, 1, 2 or 3 ;
• 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. And for Raspberry Pi Zero Wireless.)

---

Installation using the image (recommended)

0. Download the pre-installed image for Raspberry Pi

1. Copy image to the SD card

2. Plug & boot

3. Connect to your server with SSH

4. Proceed to post-installation

---

Manual installation (advanced users)

We do not recommend the manual installation because it is more technical and longer than using the pre-installed image. This documentation is only intended for advanced users.

The latest Rasbpian images 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 Stretch Lite on the SD card (instructions).

1. Connect to your Raspberry Pi with the user pi. Set the root password with

sudo passwd root

2. Edit /etc/ssh/sshd_config to allow ssh login for root, by replacing PermitRootLogin without-password with PermitRootLogin yes. Reload the ssh daemon with service ssh reload.

3. Disconnect and reconnect, this time as root.

4. Then follow the generic manual install procedure.