doc/install_on_raspberry.md
2017-01-29 17:30:54 +01:00

2.4 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

  • A Raspberry Pi model 0, 1, 2 or 3
  • An SD card: 4GB capacity (or more) and class10 speed rate is 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)
  • YunoHost Raspberry Pi image, availabe on build.yunohost.org. Not needed if you want to manually install YunoHost on a existing Debian system.
  • (Optional) A screen and a keyboard, if you can't use an ssh connection to proceed to the post-installation. Note: 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. Post-install


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.