doc/install_on_raspberry.md
2017-01-30 23:33:28 +01:00

2.2 KiB

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 [limitations imposed by your ISP](/isp). If they are too restrictive you can consider using a VPN to get around those limitations.

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.)
  • (Optional) A screen and a keyboard, if you can't use an ssh connection to proceed to the post-installation. (Not needed when installing with an image.)

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

  1. Install Raspbian on the SD card and connect to your Pi.

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

sudo passwd root
  1. Install git
sudo apt-get install git
  1. Clone the Yunohost install script repository
git clone https://github.com/YunoHost/install_script /tmp/install_script
  1. 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.