From 5be8a1f35bc95df983fdc7c21e40e22fe0288da8 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Wed, 14 May 2014 19:33:28 +0200 Subject: [PATCH] Add install_on_raspberry.md --- install_on_raspberry.md | 80 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 install_on_raspberry.md diff --git a/install_on_raspberry.md b/install_on_raspberry.md new file mode 100644 index 00000000..06b97e2e --- /dev/null +++ b/install_on_raspberry.md @@ -0,0 +1,80 @@ +# Install YunoHost on a Raspberry Pi + +*Find other ways to install YunoHost **[here](/install)**.* + +## 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](/isp), preferably with a good and unlimited upstream bandwidth +* The **YunoHost Raspberry image**, available here: + + [http://build.yunohost.org/raspberry-latest.img](http://build.yunohost.org/raspberry-latest.img) + +## 1. Copy the image to your SD card + +#### On Windows +* Download and install **[Win32 Disk Imager](http://sourceforge.net/projects/win32diskimager/)** +* 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: + +```bash +sudo fdisk -l +``` + +It should be `/dev/diskN`, where `N` is a number, or `/dev/sdX`, where `X` is a number. + +* Copy the image by typing: + +```bash +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. + +Your SD card is now ready to be used. **:-)** + +## 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: + +```bash +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](/postinstall)**