diff --git a/copy_image.md b/copy_image.md index 6cd22d68..c2312fb6 100644 --- a/copy_image.md +++ b/copy_image.md @@ -1,46 +1,46 @@ -# Copy an image to an SD card +# Flashing an SD card -Now that you have the YunoHost image, you have to copy its content to an SD card. -The process differs regarding your operating system. +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. + +
+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). +
-## On Windows +### With Etcher -* Download and install **[Win32 Disk Imager](http://sourceforge.net/projects/win32diskimager/)** -* Plug your SD card in -* Copy the `.img` file to your SD card using Win32 Disk Imager. +Download Etcher for your +operating system and install it. - + -## On GNU/Linux, BSD or Mac OS +Plug your SD card, select your YunoHost image and click "Flash" -* Open a terminal -* Plug your SD card in -* Identify the device name by typing: +### With `dd` + +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 : ```bash -sudo fdisk -l +dd if=/path/to/yunohost.img of=/dev/mmcblk0 ``` -It should be `/dev/diskN`, where `N` is a number, or `/dev/sdX`, where `X` is a letter. - -Carefull to not put the digit `N` cause it will create an [non-functional SD card](https://raspberrypi.stackexchange.com/questions/11880/sd-card-doesnt-works-after-dd). - -* Copy the image by typing: - -```bash -sudo dd if=/path/to/your/.img of=/your/device/name -``` - - Do not forget to change `/path/to/your/.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. **:-)** - ## Expand the root partition (optional) +
+This step is optionnal as it should be performed automatically during the first +boot on recent images. +
+ 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). +You can resize it by using software like `resize2fs` (command-line) or `gparted` +(graphical). diff --git a/copy_image_fr.md b/copy_image_fr.md index 25896d7f..f2e0509a 100644 --- a/copy_image_fr.md +++ b/copy_image_fr.md @@ -1,45 +1,51 @@ -# Copier l’image sur une carte SD +# Flasher une carte SD -Maintenant que vous avez l’image ISO YunoHost, vous devez la copier sur une carte SD. Le processus est différent suivant votre système d’exploitation. +Maintenant que vous avez téléchargé l'image de YunoHost, il vous faut copier son +contenu sur une carte SD. Cette étape est aussi souvent appelé 'flasher' la +carte SD. + +
+Dans le contexte de l'auto-hébergement, il est recommandé que votre carte SD +fasse au moins 8 Go (pour disposer d'un espace raisonnable pour le système et +quelques données) et soit au moins certifiée classe 10 (pour avoir des +performances raisonnables). +
-## Sous Windows +### Avec Etcher -* Téléchargez et installez **[Win32 Disk Imager](http://sourceforge.net/projects/win32diskimager/)**. -* Insérez votre carte SD. -* Copiez le fichier `.img` sur votre carte SD en utilisant *Win32 Disk Imager*. +Télécharger Etcher pour votre +système d'exploitation, et installez-le. - + -## Sous GNU/Linux, BSD ou Mac OS +Connectez votre carte SD, sélectionnez votre image YunoHost, puis cliquez sur +'Flash'. -* Ouvrez un terminal. -* Insérez votre carte SD. -* Identifiez votre matériel en tapant : +### Avec `dd` + +Si vous êtes sous Linux / Mac et que vous être à l'aise avec la ligne de +commande, vous pouvez aussi flasher votre carte SD avec `dd`. Commencez par +identifier le périphérique correspondant à votre carte SD avec `fdisk -l` ou +`lsblk`. En supposant que votre carte SD soit `/dev/mmcblk0` (faites attention +!), vous pouvez lancer : ```bash -sudo fdisk -l +dd if=/chemin/vers/yunohost.img of=/dev/mmcblk0 ``` -Ça devrait être `/dev/diskN`, où `N` est un chiffre, ou `/dev/sdX`, où `X` est une lettre, ou `/dev/mmcblk0`. +## Étendre la partition root (optionnel) -Attention à ne pas mettre le chiffre `N` car ça créera une [carte SD non fonctionnelle](https://raspberrypi.stackexchange.com/questions/11880/sd-card-doesnt-works-after-dd). +
+Cette étape est optionnelle car elle est normalement effectuée automatiquement +par le système lors du premier démarrage sur les images récentes. +
-* Copiez l’image en tapant : - -```bash -sudo dd if=/chemin/vers/votre/.img of=/nom/du/matériel -``` - - N’oubliez pas de changer `/chemin/vers/votre/.img` et `/nom/du/matériel` par les valeurs appropriées. - -La commande peut prendre quelques minutes, puis votre carte SD sera prête à être utilisée. **:-)** - -## Étendre la partition root (facultatif, mais conseillé) - -Par défaut, la partition root installée sur votre carte SD avec la commande `dd` est très petite. -Vous pouvez la redimensionner avec un logiciel comme `resize2fs` (ligne de commande) ou `Gparted` (interface graphique) en étendant la partition ext4 au maximum de façon à utiliser tout l’espace non alloué. +Par défaut, la partition root installée sur votre carte SD avec la commande `dd` +est très petite. Vous pouvez la redimensionner avec un logiciel comme +`resize2fs` (ligne de commande) ou `Gparted` (interface graphique) en étendant +la partition ext4 au maximum de façon à utiliser tout l’espace non alloué.