doc/install_on_raspberry.md
2016-11-04 11:27:45 +01:00

2.8 KiB

Install YunoHost on a Raspberry Pi

Find other ways to install YunoHost here.

Pre-requisite

  • A Raspberry Pi model 1, 2 or 3
  • An SD card: 4GB capacity (or more) and class10 speed rate are highly recommended
  • An other computer to read this guide and access to your Raspberry Pi
  • A screen and a keyboard are recommended to control your Raspberry Pi if a problem occurs.
  • A reasonable ISP, preferably with a good and unlimited upstream bandwidth
  • YunoHost Raspberry Pi images, available here:

build.yunohost.org

There are two ways of installing, depending on if you can start your server from scratch or not.


Installation using an image

1. Copy image to the SD card

2. Plug & boot

3. Post-install

Manual installation

Follow these steps if you can't start from scratch and simply use an image. Note - Yunohost installation is different if you have a Raspberry Pi Zero, be careful!

  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. The root user must have a password set, if it isn't the case, set it (whithout the install script failed):
sudo passwd root
  1. Update the Pi:
apt-get update ; apt-get dist-upgrade -y ; apt-get install rpi-update ; rpi-update ; reboot`

This will upgrade the Pi, then reboot.

Raspberry Pi Zero users: follow these specific steps for a successfull installation.

0.1 Install metronome manually:

apt-get install -y ssl-cert lua-event lua-expat lua-socket lua-sec lua-filesystem
wget https://github.com/YunoHost/metronome/archive/debian/3.7.9+33b7572-1.zip
unzip 3.7.9+33b7572-1.zip
cd metronome-debian-3.7.9-33b7572-1
dpkg-buildpackage -rfakeroot -uc -b -d
cd ..
dpkg -i metronome_3.7.9+33b7572-1_armhf.deb
apt-mark hold metronome
  1. Execute the installation script
cd /tmp/install_script && sudo ./install_yunohost

Recommended after post-installation

  • Connect via SSH: root@IP.OF.RPI (password: yunohost)
  • Change root password: passwd root
  • Upgrade system: apt-get update && apt-get dist-upgrade && rpi-update
  • Configure the language, keyboard layout and timezone with the raspi-config tool

Build image

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