mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
85 lines
3.3 KiB
Markdown
85 lines
3.3 KiB
Markdown
# 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)
|
|
|
|
## <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).*
|
|
|