doc/copy_image.md

48 lines
1.6 KiB
Markdown
Raw Normal View History

# Flashing an SD card
2014-06-05 01:25:25 +02:00
Now that you download the YunoHost image, you have to copy its content to an SD
card. This step is also sometimes called 'flashing' the SD card.
2014-06-05 18:22:36 +02:00
<div class="alert alert-warning" markdown="1">
In the context of self-hosting, it is recommended that your SD card be at least
8 GB (to have a reasonable space available for the system and a few data) and at
least Class 10 (to ensure reasonable performances).
</div>
2014-06-05 18:22:36 +02:00
<img src="/images/sdcard.jpg" width=150><img src="https://yunohost.org/images/micro-sd-card.jpg">
2014-06-05 01:25:25 +02:00
### With Etcher
2014-06-05 18:22:36 +02:00
Download <a href="https://etcher.io/" target="_blank">Etcher</a> for your
operating system and install it.
2014-06-05 18:22:36 +02:00
<img src="/images/etcher.gif">
2014-06-05 01:25:25 +02:00
Plug your SD card, select your YunoHost image and click "Flash"
2014-06-05 01:25:25 +02:00
### With `dd`
2014-06-05 01:25:25 +02:00
If you are on Linux / Mac and know your way around command line, you may also
flash your SD card with `dd`. You can identify which device corresponds to your
SD card with `fdisk -l` or `lsblk`. Assuming your SD card is `/dev/mmcblk0` (be
careful !!), you may run :
2014-06-05 01:25:25 +02:00
```bash
dd if=/path/to/yunohost.img of=/dev/mmcblk0
2014-06-05 01:25:25 +02:00
```
2014-06-05 18:22:36 +02:00
## Expand the root partition <small>(optional)</small>
<div class="alert alert-warning" markdown="1">
2019-01-29 03:05:22 +01:00
This step is optional as it should be performed automatically during the first
boot on recent images.
</div>
2014-06-05 18:22:36 +02:00
By default, the root partition of your SD card is very small.
You can resize it by using software like `resize2fs` (command-line) or `gparted`
(graphical).
2014-06-05 18:22:36 +02:00
<img src="/images/gparted.jpg" style="max-width:100%;border-radius: 5px;border: 1px solid rgba(0,0,0,0.15);box-shadow: 0 5px 15px rgba(0,0,0,0.35);">
2014-06-05 11:44:19 +02:00
<p class="text-muted">Preview of the Gparted window</p>