doc/install_on_raspberry.md

# 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.gz](http://build.yunohost.org/raspberry-latest.img.gz)

## <small>1.</small> 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 letter.

* 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.

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

## <small>2.</small> 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**.

## <small>3.</small> 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. For further precision, refer to the **[post-installation page](/postinstall)**.

## <small>4.</small> 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.

---

#### *If you need help during one of these steps, do not hesitate to use [our support tools](/support).*