doc/install_on_raspberry.md
2014-05-15 01:09:17 +02:00

2.9 KiB

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

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.


You can get more information on the post-installation process here:

https://yunohost.org/postinstall