Install YunoHost on a Raspberry Pi

Find other ways to install YunoHost here.

Pre-requisite

A Raspberry Pi model B -- Model A should work, but remains untested
An SD card: 4GB capacity (or more) and class10 speed rate are highly recommended
Another computer to read this guide and to access 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
The YunoHost Raspberry image, available here:

http://build.yunohost.org/raspberry-latest.img.gz

1. Copy the image to your SD card

On Windows

Download and install Win32 Disk Imager
Plug your SD card in
Copy the raspberry-latest.img file to your SD card using Win32 Disk Imager.

On GNU/Linux, BSD or Mac OS X

Open a terminal
Plug your SD card in
Identify the device name by typing:

sudo fdisk -l

It should be /dev/diskN, where N is a number, or /dev/sdX, where X is a letter.

Copy the image by typing:

sudo dd bs=1M if=/path/to/your/raspberry-latest.img of=/your/device/name

Do not forget to change /path/to/your/raspberry-latest.img and /your/device/name with the appropriate values.

The command may take a few minutes, then your SD card will be ready to use. :-)

2. Boot up the Raspberry Pi

Put the SD card in the Raspberry Pi and plug the Ethernet cable in
Do not forget to plug a screen if you want to see how boot is going, and a keyboard if you want to have a command-line access to your Raspberry Pi
Plug the USB power and wait until you see a big squared Y

You should be able to see an IP address field on the screen, write it down: It is your Raspberry Pi local IP address.

3. Post-Installation

You have two different ways to configure YunoHost, it just has to be done once:

Web

On your other computer, open a web browser and type down your local IP address in the address bar. It should looks like https://192.168.1.3.

A warning message appears, just ignore it by clicking the "Proceed Anyway" or "Add an exception" button.

You are now on the post-installation screen, follow the instructions and proceed. Remember that your Raspberry Pi is not really powerful, this process may thus take several minutes.

Command-line

If you choose to do the post-installation process directly from your Raspberry Pi, log in at boot screen with the credentials root / yunohost, and execute:

yunohost tools postinstall

The administration password and a domain will be asked. For further precision, refer to the post-installation page.

4. System upgrade

It is wisely recommended to execute a full system upgrade as soon as possible. To do so, you have to go to the administration interface by entering its URL in a web browser: https://<your_domain.org>/yunohost/admin, then click on "Tools" and "System upgrade".

The operation may take a few minutes, then confirm the package upgrade and wait a few more minutes.

3.5 KiB Raw Blame History