YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

[en] Improve install pages

Browse source
This commit is contained in:
Yunobot 2021-01-09 21:36:09 +01:00
parent 05fff49884
commit 7a068306db
6 changed files with 55 additions and 63 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
pages/01.administrate/02.install/01.iso/01.burn_iso/burn_or_copy_iso.md
View file

@ -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**. 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**.
<img src="/images/sdcard.jpg" width=100> [center]
<img src="/images/micro-sd-card.jpg" width=100> ![SD card](image://sdcard.jpg?resize=100,100&class=inline)
<img src="/images/usb_key.png" width=150> ![Micro SD card](image://micro-sd-card.jpg?resize=100,100&class=inline)
<img src="/images/cd.jpg" width=100> ![USB drive](image://usb_key.png?resize=100,100&class=inline)
![CD](image://cd.jpg?resize=100,100&class=inline)
[/center]
### (Recommended) With Etcher ### (Recommended) With Etcher
Download <a href="https://etcher.io/" target="_blank">Etcher</a> for your operating system and install it. Download <a href="https://www.balena.io/etcher/" target="_blank">Etcher</a> for your operating system and install it.
<img src="/images/etcher.gif"> [center]
![Etcher](image://etcher.gif?resize=100%&class=inline)
[/center]
Plug your USB stick, select your YunoHost ISO and click "Flash" 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 <a href="https://unetbootin.github.io/">UNetbootin</a> for your operating system and install it. Download <a href="https://unetbootin.github.io/">UNetbootin</a> for your operating system and install it.
<img src="/images/unetbootin.png"> [center]
![UNetbootin](image://unetbootin.png?resize=100%&class=inline)
[/center]
Put your USB stick on, select your YunoHost ISO and click "OK" Put your USB stick on, select your YunoHost ISO and click "OK"

41
pages/01.administrate/02.install/01.iso/02.graphical_install/boot_and_graphical_install.md
View file

@ -7,51 +7,44 @@ taxonomy:
Now that your YunoHost install medium, you can start with the installation. Now that your YunoHost install medium, you can start with the installation.
## <small>1.</small> 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**. 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. 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
## <small>2.</small> 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): 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):
```<ESC>```, ```<F9>```, ```<F10>```, ```<F11>```, ```<F12>``` or ```<DEL>``` ```<ESC>```, ```<F9>```, ```<F10>```, ```<F11>```, ```<F12>``` or ```<DEL>```
## <small>3.</small> Launch graphical installation ## 3. Launch graphical installation
You should see a screen like this: You should see a screen like this:
<img src="/images/virtualbox_3.png"> ![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. ## 4. Log in
<div class="alert alert-danger"><b>Caution:</b> This will totally erase the data on your hard drive</div>
* Let the installer do the rest, it will download required packages and install them.
<div class="alert alert-info">If it fails, you probably have an Internet connection issue.
Check that your computer is physically connected and retry.</div>
* It should reboot automatically.
## <small>4.</small> Log in
After the reboot, you should see a black screen with a few words asking you to 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 : log in. You can log with the following credentials :
* User: **root** * User: `root`
* Password: **yunohost** * Password: `yunohost`
## <small>5.</small> Proceed to post-installation ## 5. Proceed to post-installation
<a class="btn btn-lg btn-default" href="/postinstall">Post-install documentation</a> <a class="btn btn-lg btn-default" href="/administrate/postinstall">Post-install documentation</a>

10
pages/01.administrate/02.install/01.iso/install_iso.md
View file

@ -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) [0. Download the YunoHost ISO image](/administrate/install/iso/images?classes=btn,btn-lg,btn-primary)
<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Burn the ISO image on a USB stick</a> [1. Burn the ISO image on a USB stick](/administrate/install/iso/burn_iso?classes=btn,btn-lg,btn-primary)
<a class="btn btn-lg btn-default" href="/boot_and_graphical_install">2. Boot the machine and run the installation</a> [2. Boot the machine and run the installation](/administrate/install/iso/graphical_install?classes=btn,btn-lg,btn-primary)
<a class="btn btn-lg btn-default" href="/postinstall">3. Proceed with the initial configuration (post-installation)</a> [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: To connect directly to your computer or with [SSH](/ssh) (only on local network:
* User: **root** * User: `root`
* Password: **yunohost** * Password: `yunohost`

6
pages/01.administrate/02.install/02.vps/install_on_vps.md
View file

@ -9,7 +9,7 @@ taxonomy:
### Pre-requisite ### Pre-requisite
<img src="/images/vps.png" width=250> ![VPS](image://vps.png?resize=250)
* A dedicated or virtual private server * A dedicated or virtual private server
* with at least **512MB** RAM * with at least **512MB** RAM
@ -19,6 +19,6 @@ taxonomy:
## Installation steps ## Installation steps
<a class="btn btn-lg btn-default" href="/install_manually">1. Install manually</a> [1. Install manually](/administrate/install/manualinstall?classes=btn,btn-lg,btn-primary)
<a class="btn btn-lg btn-default" href="/postinstall">2. Proceed with the initial configuration (post-installation)</a> [2. Proceed with the initial configuration (post-installation)](/administrate/postinstall?classes=btn,btn-lg,btn-primary)

14
pages/01.administrate/02.install/03.manualinstall/install_manually.md
View file

@ -5,23 +5,21 @@ taxonomy:
category: docs category: docs
--- ---
<div class="alert alert-info"> ! This procedure only works on **Debian 10** machines <small>(with **kernel >= 3.12**)</small>)
This procedure only works on **Debian 10** machines <small>(with **kernel >= 3.12**)</small>)
</div>
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 ```bash
curl https://install.yunohost.org | bash curl https://install.yunohost.org | bash
``` ```
<small>*(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`)*</small> !!! 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) Once the installation is finished, you may want to [**proceed to post-installation**](/postinstall)
--- ---
**Note for advanced users concerned with the `curl|bash` approach** !!! **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).
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).

23
pages/01.administrate/02.install/04.rpi/install_on_raspberry.md
View file

@ -7,20 +7,19 @@ taxonomy:
*Find all the ways to install YunoHost **[here](/install)**.* *Find all the ways to install YunoHost **[here](/install)**.*
<center> [center]
<img src="/images/raspberrypi.jpg" width=300 style="padding-bottom:20px"> ![Raspberry Pi](image://raspberrypi.jpg?resize=300&class=inline)
<img src="/images/micro-sd-card.jpg"> ![Micro SD card](image://micro-sd-card.jpg?class=inline)
</center> [/center]
<div class="alert alert-info" markdown="1"> ! Before setting up a server at home, it is recommended that you know the [possible limitations imposed by your ISP](/administrate/advance/isp).
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. ! If they are too restrictive, you might consider using a VPN to bypass them.
</div>
## Pre-requisites ## 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)) ; - 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 ; - 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).); - 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. - 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) ## Manual installation (advanced users)
<div class="alert alert-warning" markdown="1"> ! 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.
</div>
<div class="alert alert-warning" markdown="1"> ! 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).
</div>
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/ 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/