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**.
<img src="/images/sdcard.jpg" width=100>
<img src="/images/micro-sd-card.jpg" width=100>
<img src="/images/usb_key.png" width=150>
<img src="/images/cd.jpg" width=100>
[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 <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"
@ -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.
<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"

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.
## <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**.
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.
## <small>2.</small> 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):
```<ESC>```, ```<F9>```, ```<F10>```, ```<F11>```, ```<F12>``` or ```<DEL>```
## <small>3.</small> Launch graphical installation
## 3. Launch graphical installation
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.
<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
## 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`
## <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)
<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:
* User: **root**
* Password: **yunohost**
* User: `root`
* Password: `yunohost`

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

@ -9,7 +9,7 @@ taxonomy:
### Pre-requisite
<img src="/images/vps.png" width=250>
![VPS](image://vps.png?resize=250)
* A dedicated or virtual private server
* with at least **512MB** RAM
@ -19,6 +19,6 @@ taxonomy:
## 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
---
<div class="alert alert-info">
This procedure only works on **Debian 10** machines <small>(with **kernel >= 3.12**)</small>)
</div>
! This procedure only works on **Debian 10** machines <small>(with **kernel >= 3.12**)</small>)
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
```
<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)
---
**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).

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

@ -7,21 +7,20 @@ taxonomy:
*Find all the ways to install YunoHost **[here](/install)**.*
<center>
<img src="/images/raspberrypi.jpg" width=300 style="padding-bottom:20px">
<img src="/images/micro-sd-card.jpg">
</center>
[center]
![Raspberry Pi](image://raspberrypi.jpg?resize=300&class=inline)
![Micro SD card](image://micro-sd-card.jpg?class=inline)
[/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](/isp). If they are too restrictive, you might consider using a VPN to bypass them.
</div>
! 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)
<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.
</div>
! 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 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).
</div>
! 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/