diff --git a/pages/01.administrate/02.install/01.iso/01.burn_iso/burn_or_copy_iso.md b/pages/01.administrate/02.install/01.iso/01.burn_iso/burn_or_copy_iso.md index 3b9530b5..cf3a5882 100644 --- a/pages/01.administrate/02.install/01.iso/01.burn_iso/burn_or_copy_iso.md +++ b/pages/01.administrate/02.install/01.iso/01.burn_iso/burn_or_copy_iso.md @@ -7,16 +7,20 @@ taxonomy: Now that you downloaded the ISO image of YunoHost, you should flash/burn it on a physical medium. Typically, this is done on a **USB stick** or an **SD card**. - - - - +[center] +![SD card](image://sdcard.jpg?resize=100,100&class=inline) +![Micro SD card](image://micro-sd-card.jpg?resize=100,100&class=inline) +![USB drive](image://usb_key.png?resize=100,100&class=inline) +![CD](image://cd.jpg?resize=100,100&class=inline) +[/center] ### (Recommended) With Etcher -Download Etcher for your operating system and install it. +Download Etcher for your operating system and install it. - +[center] +![Etcher](image://etcher.gif?resize=100%&class=inline) +[/center] Plug your USB stick, select your YunoHost ISO and click "Flash" @@ -24,7 +28,9 @@ Plug your USB stick, select your YunoHost ISO and click "Flash" Download UNetbootin for your operating system and install it. - +[center] +![UNetbootin](image://unetbootin.png?resize=100%&class=inline) +[/center] Put your USB stick on, select your YunoHost ISO and click "OK" diff --git a/pages/01.administrate/02.install/01.iso/02.graphical_install/boot_and_graphical_install.md b/pages/01.administrate/02.install/01.iso/02.graphical_install/boot_and_graphical_install.md index 0cd449bc..b5d52e0e 100644 --- a/pages/01.administrate/02.install/01.iso/02.graphical_install/boot_and_graphical_install.md +++ b/pages/01.administrate/02.install/01.iso/02.graphical_install/boot_and_graphical_install.md @@ -7,51 +7,44 @@ taxonomy: Now that your YunoHost install medium, you can start with the installation. -## 1. Plug the network cable +## 1. Plug the network cable If you want the network configuration to be set up automatically, you have to plug your server with an **Ethernet** cable **right behind your main router**. The wireless connections are not supported yet, and if you use intermediate routers, the network ports opening will not be automatic: Your server will not be accessible externally. - -## 2. Boot on CD / USB stick +## 2. Boot on CD / USB stick Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device** by pressing one of the following keys (hardware specific): ``````, ``````, ``````, ``````, `````` or `````` -## 3. Launch graphical installation +## 3. Launch graphical installation You should see a screen like this: - +![VirtualBox](image://virtualbox_3.png?class=center) +1. Select `Graphical install` +2. Select your language, your location and your keyboard layout +3. If a partitioning screen appears, confirm. + !! This will totally erase the data on your hard drive +4. Let the installer do the rest, it will download required packages and install them. -* Select `Graphical install` + ! If it fails, you probably have an Internet connection issue. + ! Check that your computer is physically connected and retry. -* Select your language, your location and your keyboard layout +5. It should reboot automatically. -* If a partitioning screen appears, confirm. - -
Caution: This will totally erase the data on your hard drive
- - -* Let the installer do the rest, it will download required packages and install them. - -
If it fails, you probably have an Internet connection issue. -Check that your computer is physically connected and retry.
- -* It should reboot automatically. - -## 4. Log in +## 4. Log in After the reboot, you should see a black screen with a few words asking you to log in. You can log with the following credentials : -* User: **root** -* Password: **yunohost** +* User: `root` +* Password: `yunohost` -## 5. Proceed to post-installation +## 5. Proceed to post-installation -Post-install documentation +Post-install documentation diff --git a/pages/01.administrate/02.install/01.iso/install_iso.md b/pages/01.administrate/02.install/01.iso/install_iso.md index bb6e0f52..2fd0eb1a 100644 --- a/pages/01.administrate/02.install/01.iso/install_iso.md +++ b/pages/01.administrate/02.install/01.iso/install_iso.md @@ -26,15 +26,15 @@ You can use any computer with **256MB RAM or more**. [0. Download the YunoHost ISO image](/administrate/install/iso/images?classes=btn,btn-lg,btn-primary) -1. Burn the ISO image on a USB stick +[1. Burn the ISO image on a USB stick](/administrate/install/iso/burn_iso?classes=btn,btn-lg,btn-primary) -2. Boot the machine and run the installation +[2. Boot the machine and run the installation](/administrate/install/iso/graphical_install?classes=btn,btn-lg,btn-primary) -3. Proceed with the initial configuration (post-installation) +[3. Proceed with the initial configuration (post-installation)](/administrate/postinstall?classes=btn,btn-lg,btn-primary) --- To connect directly to your computer or with [SSH](/ssh) (only on local network: -* User: **root** -* Password: **yunohost** +* User: `root` +* Password: `yunohost` diff --git a/pages/01.administrate/02.install/02.vps/install_on_vps.md b/pages/01.administrate/02.install/02.vps/install_on_vps.md index 8a0aa382..f7617fac 100644 --- a/pages/01.administrate/02.install/02.vps/install_on_vps.md +++ b/pages/01.administrate/02.install/02.vps/install_on_vps.md @@ -9,7 +9,7 @@ taxonomy: ### Pre-requisite - +![VPS](image://vps.png?resize=250) * A dedicated or virtual private server * with at least **512MB** RAM @@ -19,6 +19,6 @@ taxonomy: ## Installation steps -1. Install manually +[1. Install manually](/administrate/install/manualinstall?classes=btn,btn-lg,btn-primary) -2. Proceed with the initial configuration (post-installation) +[2. Proceed with the initial configuration (post-installation)](/administrate/postinstall?classes=btn,btn-lg,btn-primary) diff --git a/pages/01.administrate/02.install/03.manualinstall/install_manually.md b/pages/01.administrate/02.install/03.manualinstall/install_manually.md index 83dc2fe8..36e5a208 100644 --- a/pages/01.administrate/02.install/03.manualinstall/install_manually.md +++ b/pages/01.administrate/02.install/03.manualinstall/install_manually.md @@ -5,23 +5,21 @@ taxonomy: category: docs --- -
-This procedure only works on **Debian 10** machines (with **kernel >= 3.12**)) -
+! This procedure only works on **Debian 10** machines (with **kernel >= 3.12**)) -Once you have access to a command line on your server (either directly or through SSH), you can install yunohost by running command as root : +Once you have access to a command line on your server (either directly or through SSH), you can install YunoHost by running command as root : ```bash curl https://install.yunohost.org | bash ``` -*(If `curl` is not installed on your system, you might need to install it with `apt install curl`. Otherwise, if the command does not do anything, you might want to `apt install ca-certificates`)* +!!! If `curl` is not installed on your system, you might need to install it with `apt install curl`. +!!! Otherwise, if the command does not do anything, you might want to `apt install ca-certificates` Once the installation is finished, you may want to [**proceed to post-installation**](/postinstall) --- -**Note for advanced users concerned with the `curl|bash` approach** - -If you strongly object to the `curl|bash` way (and similar commands) of installing software, consider reading ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) on Sandstom's blog, and possibly [this discussion on Hacker News](https://news.ycombinator.com/item?id=12766350). +!!! **Note for advanced users concerned with the `curl|bash` approach:** +!!! If you strongly object to the `curl|bash` way (and similar commands) of installing software, consider reading ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) on Sandstom's blog, and possibly [this discussion on Hacker News](https://news.ycombinator.com/item?id=12766350). diff --git a/pages/01.administrate/02.install/04.rpi/install_on_raspberry.md b/pages/01.administrate/02.install/04.rpi/install_on_raspberry.md index a058ca3a..3b5b9a37 100644 --- a/pages/01.administrate/02.install/04.rpi/install_on_raspberry.md +++ b/pages/01.administrate/02.install/04.rpi/install_on_raspberry.md @@ -7,21 +7,20 @@ taxonomy: *Find all the ways to install YunoHost **[here](/install)**.* -
- - -
+[center] +![Raspberry Pi](image://raspberrypi.jpg?resize=300&class=inline) +![Micro SD card](image://micro-sd-card.jpg?class=inline) +[/center] -
-Before setting up a server at home, it is recommended that you know the [possible limitations imposed by your ISP](/isp). If they are too restrictive, you might consider using a VPN to bypass them. -
+! Before setting up a server at home, it is recommended that you know the [possible limitations imposed by your ISP](/administrate/advance/isp). +! If they are too restrictive, you might consider using a VPN to bypass them. ## Pre-requisites -- A Raspberry Pi 2, 3 or 4 (RPi 0 and 1 may work but require some tweaking... see [this issue](https://github.com/YunoHost/issues/issues/1423)) ; +- A Raspberry Pi 2, 3 or 4 (RPi 0 and 1 may work but require some tweaking... see [this issue](https://github.com/YunoHost/issues/issues/1423)); - An microSD card: **8GB** capacity (at least) and **Class 10** speed rate are highly recommended (like the [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ; -- A power supply (either an adapter or a MicroUSB cable)i ; -- An ethernet cable (RJ-45) to connect your Raspberry Pi to your router. (Raspberry Pi Zero users can connect the Pi using an OTG cable, [Wifi dongle](https://core-electronics.com.au/tutorials/raspberry-pi-zerow-headless-wifi-setup.html).) ; +- A power supply (either an adapter or a MicroUSB cable); +- An ethernet cable (RJ-45) to connect your Raspberry Pi to your router. (Raspberry Pi Zero users can connect the Pi using an OTG cable, [Wifi dongle](https://core-electronics.com.au/tutorials/raspberry-pi-zerow-headless-wifi-setup.html).); - A [reasonable ISP](/isp), preferably with a good and unlimited upload bandwidth. --- @@ -42,13 +41,9 @@ Before setting up a server at home, it is recommended that you know the [possibl ## Manual installation (advanced users) -
-We do not recommend the manual installation because it is more technical and longer than using the pre-installed image. This documentation is only intended for advanced users. -
+! We do not recommend the manual installation because it is more technical and longer than using the pre-installed image. This documentation is only intended for advanced users. -
-The latest Raspberry Pi OS images requires a screen and a keyboard, as it is no longer possible to connect directly to the Raspberry through SSH. Nevertheless it is possible to re-enable SSH at boot: before starting your Raspberry, put in the boot partition of the SD card an empty file named `ssh` (without extension). -
+! The latest Raspberry Pi OS images requires a screen and a keyboard, as it is no longer possible to connect directly to the Raspberry through SSH. Nevertheless it is possible to re-enable SSH at boot: before starting your Raspberry, put in the boot partition of the SD card an empty file named `ssh` (without extension). 0. Install Raspberry Pi OS Lite on the SD card ([instructions](https://www.raspberrypi.org/downloads/raspberry-pi-os/)). The Raspberry Pi OS Lite can be found here: https://downloads.raspberrypi.org/raspbian_lite/images/