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

[enh] New install process

Browse source
This commit is contained in:
ljf 2021-02-07 17:28:00 +01:00
parent 6866aa0fd3
commit 3bca5cb261
33 changed files with 372 additions and 1373 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -1,42 +1,392 @@
--- ---
title: Install on a regular computer title: Install YunoHost
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
never_cache_twig: true
twig_first: true
process:
markdown: true
twig: true
routes: routes:
default: '/install_iso' default: '/install_process'
aliases:
- '/docker'
- '/install_iso'
- '/install_on_vps'
- '/install_manually'
- '/install_on_raspberry'
- '/install_on_arm_board'
- '/install_on_debian'
- '/install_on_virtualbox'
- '/plug_and_boot'
- '/burn_or_copy_iso'
- '/boot_and_graphical_install'
--- ---
{% set arm, at_home, regular, rpi2plus, rpi1, rpi0, arm_sup, arm_unsup, vps, vps_debian, vps_ynh, virtualbox, internetcube, docker = false, false, false, false, false, false, false, false, false, false, false, false, false, false %}
{% if uri.param('hardware') == 'regular' %}
{% set regular = true %}
{% elseif uri.param('hardware') == 'internetcube' %}
{% set arm, arm_sup, internetcube = true, true, true %}
{% elseif uri.param('hardware') == 'rpi2plus' %}
{% set arm, rpi2plus = true, true %}
{% elseif uri.param('hardware') == 'rpi1' %}
{% set arm, rpi1 = true, true %}
{% elseif uri.param('hardware') == 'rpi0' %}
{% set arm, rpi0 = true, true %}
{% elseif uri.param('hardware') == 'arm_sup' %}
{% set arm, arm_sup = true, true %}
{% elseif uri.param('hardware') == 'arm_unsup' %}
{% set arm, arm_unsup = true, true %}
{% elseif uri.param('hardware') == 'vpsdebian' %}
{% set vps, vps_debian = true, true %}
{% elseif uri.param('hardware') == 'vpsynh' %}
{% set vps, vps_ynh = true, true %}
{% elseif uri.param('hardware') == 'virtualbox' %}
{% set at_home, virtualbox = true, true %}
{% elseif arm or regular %}
{% set at_home = true %}
{% elseif uri.param('hardware') == 'docker' %}
{% set docker = true %}
{% endif %}
## Requirements {% if docker %}
!! **YunoHost doesn’t support Docker officially since issues with versions 2.4+. In question, YunoHost 2.4+ doesn’t work anymore on Docker because YunoHost requires systemd and Docker has chosen to not support it natively (and there are other problems link to the firewall and services).**
!!
!! **We strongly discourage you to run YunoHost on docker with those images**
[center] ## Community images
![Laptop](image://laptop.png?resize=200,200&class=inline)
![Desktop](image://desktop.jpg?resize=200,200&class=inline) However, community images exist and are available on Docker Hub:
![Nettop](image://nettop.jpg?resize=200,200&class=inline)
[/center] * [AMD64 (classic) (ancienne version de YunoHost)](https://hub.docker.com/r/domainelibre/yunohost/)
* [I386 (old computers) (ancienne version de YunoHost)](https://hub.docker.com/r/domainelibre/yunohost-i386/)
* [ARMV7 (Raspberry Pi 2/3 ...) (ancienne version de YunoHost)](https://hub.docker.com/r/domainelibre/yunohost-arm/)
* [ARMV6 (Raspberry Pi 1) (old yunoHost version)](https://hub.docker.com/r/tuxalex/yunohost-armv6/)
{% else %}
## Pre-requisites
[figure class="nomargin" caption="On a regular computer"]
![](image://computer.png?resize=150,150&class=inline)
[/figure]
{% if regular %}
* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop ...
{% elseif rpi2plus %}
* A Raspberry Pi 2, 3 or 4 ...
{% elseif rpi1 %}
* A RPi 1 ...
{% elseif rpi0 %}
* A RPi zero ...
{% elseif arm_sup %}
* An Orange Pi PC+, or an Onlinuxino Lime 1 or 2 ...
{% elseif arm_unsup %}
* An ARM board with 500MHz CPU ...
{% elseif vps_debian %}
* A dedicated or virtual private server with Debian 10 <small>(with **kernel >= 3.12**)</small>)
preinstalled ...
{% elseif vps_ynh %}
* A dedicated or virtual private server with yunohost preinstalled ...
{% elseif virtualbox %}
* An x86 computer with VirtualBox installed and enough RAM capacity to be able to run a small virtual machine ...
{% endif %}
* ... with 512MB RAM{% if not arm %} and 15GB capacity{% endif %} (at least)
{% if arm %}
* A power supply (either an adapter or a MicroUSB cable) for your board;
* A microSD card: 16GB capacity (at least) and Class 10 speed rate are highly recommended (like the Transcend 300x);
{% endif %}
{% if regular %}
* A USB stick of at least 1GB capacity OR a standard blank CD
{% endif %}
{% if at_home %}
* A reasonable ISP, preferably with a good and unlimited upstream bandwidth
{% if rpi0 %}
* An usb OTG or a wifi dongle to connect your Raspberry Pi Zero
{% else %}
* An ethernet cable (RJ-45) to connect your server to your router.
{% endif %}
* A computer to read this guide, write the image and access to your server.
{% endif %}
{% if not at_home %}
* A computer or a smartphone to read this guide and access to your server.
{% endif %}
{% if virtualbox %}
! N.B. : Installing YunoHost in a VirtualBox is usually intended for testing. To run an actual server on the long-term, you usually need a dedicated physical machine (old computer, ARM board...) or a VPS online.
{% endif %}
{% if at_home %}
## Download the YunoHost image
<div id="cards-list">
<div id="regularcomputer64" class="card panel panel-default" style="max-width:400px">
<div class="panel-body text-center">
<h3>Regular computer</h3>
<div class="card-comment">64 bits - default</div>
<div class="card-desc text-center">
![Regular computer](image://computer.png?resize=100,100)
</div>
</div>
<div class="annotations">
<div class="col-sm-6 annotation"><a href="https://build.yunohost.org/yunohost-buster-4.1.6-amd64-stable.iso.sha256sum"><span class="glyphicon glyphicon-barcode" aria-hidden="true"></span> Checksum</a></div>
<div class="col-sm-6 annotation"><a href="https://build.yunohost.org/yunohost-buster-4.1.6-amd64-stable.iso.sig"><span class="glyphicon glyphicon-tag" aria-hidden="true"></span> Signature</a></div>
</div>
<div class="btn-group" role="group">
<a href="https://build.yunohost.org/yunohost-buster-4.1.6-amd64-stable.iso" target="_BLANK" type="button" class="btn btn-info col-sm-12"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> Télécharger <small>v.4.1.6</small></a>
</div>
</div>
</div>
{% if regular %}
!!! ***Particular case*** : If your server has no graphic card, [prepare iso for booting with serial port](https://github.com/luffah/debian-mkserialiso).
{% elseif virtualbox %}
!!! If your host OS is 32 bits, be sure that you downloaded the 32-bit image previously.
{% endif %}
{% if not virtualbox %}
## Flash the YunoHost image
Now that you downloaded the image of YunoHost, you should flash it on {% if arm %}a SD card{% else %}a USB stick or a CD.{% endif %}
{% if arm %}
![SD card](image://sdcard.jpg?resize=100,100&class=inline)
![Micro SD card](image://micro-sd-card.jpg?resize=100,100&class=inline)
{% else %}
![USB drive](image://usb_key.png?resize=100,100&class=inline)
![CD](image://cd.jpg?resize=100,100&class=inline)
{% endif %}
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Recommended) With Etcher"]
Download <a href="https://www.balena.io/etcher/" target="_blank">Etcher</a> for your operating system and install it.
![Etcher](image://etcher.gif?resize=100%&class=inline)
Plug your USB stick, select your YunoHost ISO and click "Flash"
[/ui-tab]
[ui-tab title="With UNetbootin"]
Download <a href="https://unetbootin.github.io/">UNetbootin</a> for your operating system and install it.
![UNetbootin](image://unetbootin.png?resize=100%&class=inline)
Put your USB stick on, select your YunoHost ISO and click "OK"
[/ui-tab]
[ui-tab title="With dd"]
If you are on GNU/Linux / macOS and know your way around command line, you may also flash your USB stick or SD card with `dd`. You can identify which device corresponds to your USB stick or SD card with `fdisk -l` or `lsblk`. A typical SD card name is something like `/dev/mmcblk0`. BE CAREFUL and make sure you got the right name.
Then run :
```bash
# Replace /dev/mmcblk0 if the name of your device is different...
dd if=/path/to/yunohost.img of=/dev/mmcblk0
```
[/ui-tab]
{% if regular %}
[ui-tab title="Burning a CD/DVD"]
For older devices, you might want to burn a CD/DVD. The software to use depends on your operating system.
* On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc
* On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025)
* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/)
[/ui-tab]
{% endif %}
[/ui-tabs]
{% else %}
## Create a new virtual machine
![](image://virtualbox_1.png?class=inline)
* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop.
You can use any computer with **256MB RAM or more**.
* Another computer to read this guide and access to your server.
* A [reasonable ISP](/administrate/advance/isp), preferably with a good and unlimited upstream bandwidth
* A **USB stick** of at least 1GB capacity **OR** a standard **blank CD**
* ***Particular case*** : If your server has no graphic card, [prepare iso for booting with serial port](https://github.com/luffah/debian-mkserialiso).
--- ---
## Installation steps ## Change network settings
[0. Download the YunoHost ISO image](/images?classes=btn,btn-lg,btn-primary) **NB:** You must carry out this step. If not, the install will fail.
[1. Burn the ISO image on a USB stick](/burn_or_copy_iso?classes=btn,btn-lg,btn-primary) Go to **Settings** > **Network**:
[2. Boot the machine and run the installation](/boot_and_graphical_install?classes=btn,btn-lg,btn-primary) ![](image://virtualbox_2.png?class=inline)
[3. Proceed with the initial configuration (post-installation)](/postinstall?classes=btn,btn-lg,btn-primary) * Select `Bridged adapter`
* Select your interface's name:
**wlan0** if you are connected wirelessly, else **eth0**.
--- ---
To connect directly to your computer or with [SSH](/ssh) (only on local network:
* User: `root`
* Password: `yunohost`
{% endif %}
{% if arm %}
## Power up the board
* Plug the ethernet cable.
!!! Note: 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.[details="If you have confident in your skills, it's possible to connect your server through WiFi"]If you want your server to connect using WiFi, you may configure it as explained [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md). Alternatively, you can mount the second partition of the SD card and edit the `wpa-supplicant.conf` file prior to boot the card for the first time. On Windows you can use [Paragon ExtFS](https://www.paragon-software.com/home/extfs-windows/) for this - just don't forget to unmount everytime for changes to take effect.[/details]
* Plug the SD card
* Power up the board
!!! You can also boot your server with a screen and keyboard connected to it to see how the boot process is going on.[details="See more"]This method can also be useful to troubleshoot issues and to have a direct access to it.<div class="text-center"><img src="/images/boot_screen.png"></div>[/details]
* Wait a couple minutes for your server to boot and to resize automatically partition
* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
TODO improve details feature ?
{% elseif virtualbox %}
## Boot up the virtual machine
Start the virtual machine
![](image://virtualbox_2.1.png?class=inline)
You will have to select your ISO image here, then you should see the YunoHost's boot screen.
! If you encounter the error "VT-x is not available", you need probably need to enable Virtualization in the BIOS of your computer.
{% else %}
## Boot the machine on your usb stick and run the installation
* Plug the ethernet cable.
!!! Note: 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.
* If your server was under windows 7+, ask for windows to boot on the USB stick TODO
* 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>```
{% endif %}
{% if regular or virtualbox %}
## Launch graphical install
You should see a screen like this:
[figure class="nomargin" caption="Preview of the ISO menu"]
![](image://virtualbox_3.png?class=inline)
[/figure]
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.
! If it fails, you probably have an Internet connection issue.
! Check that your computer is physically connected and retry.
5. It should reboot automatically.
TODO what to do with default credentials info ?
{% endif %}
{% else %}
## Run the install script
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`
---
!!! **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).
{% endif %}
## Proceed with initial configuration or restore an archive
!!! if you are in the process of restoring a server from scratch **and** you have a yunohost-made backup, you can skip this process and follow through with the "restoring during the postinstall" step, in the [backup](/backup) page.
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="From the web interface"]
You can perform the post-installation with the web interface by entering in your browser {%if at_home %} **`{% if internetcube %}internetcube.local{% else %}yunohost.local{% endif %}`** OR **the local IP address of your server** if it is on your local network (e.g. at home !). The address typically looks like `192.168.x.y` (see [finding your local IP](/finding_the_local_ip)){% else %} **the public IP address of your server** if your server is not on your local network. Typically, if you own a VPS, your VPS provider should have given you the IP of the server.{% endif %}
During the first visit, you will very likely encounter a security warning related to the certificate used by the server. For now, your server uses a self-signed certificate. You will later be able to add a certificate automatically recognized by web browsers as described in the [certificate documentation](/certificate). For now, you should add a security exception to accept the current certificate.
{% if not internetcube %}
You should then land on this page :
[figure class="nomargin" caption="Preview of the Web initial configuration page"]
![Initial configuration page](image://postinstall_web.png?resize=100%&class=inline)
[/figure]
{% endif %}
[/ui-tab]
[ui-tab title="From the command line"]
You can also perform the postinstallation with the command `yunohost tools postinstall` directly on the server, or [via SSH](/ssh).
[figure class="nomargin" caption="Preview of the command-line post-installation"]
![Initial configuration with CLI](image://postinstall_cli.png?resize=100%&class=inline)
[/figure]
[/ui-tab]
[/ui-tabs]
{% if not internetcube %}
### Informations asked
#### Main domain
This is the first domain name linked to your YunoHost server, but also the one which will be used by your server's users to access the **authentication portal**. It will thus be **visible by everyone**, choose it wisely.
* If you do not have a domain name, or if you want to use the YunoHost's DynDNS service, choose a sub-domain of **.nohost.me**, **.noho.st** or **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step.
* If you do know what **DNS** is, you probably want to configure your own domain name here. In this case, please refer to the [DNS page](/dns) page for more informations.
* If you don't own a domain name and don't want a **.nohost.me**, **.noho.st** or **.ynh.fr**, you can use a local domain. More information on how to setup a local domain can be found [here](/dns_local_network).
#### Administration password
This password will be used to access to your server's [administration interface](/admin). You would also use it to connect via **SSH** or **SFTP**. In general terms, this is your **system's key**, [choose it carefully](http://www.wikihow.com/Choose-a-Secure-Password).
## Create a first user
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="From the web interface"]
[/ui-tab]
[ui-tab title="From the command line"]
[/ui-tab]
[/ui-tabs]
{% endif %}
## Run diagnostic and fix DNS or Router issues if needed
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Recommended) From the web interface"]
[/ui-tab]
[ui-tab title="From the command line"]
[/ui-tab]
[/ui-tabs]
## Let's Encrypt
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="From the web interface"]
[/ui-tab]
[ui-tab title="From the command line"]
[/ui-tab]
[/ui-tabs]
{% endif %}

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

@ -1,27 +0,0 @@
---
title: Installation auf einem dedizierten Server
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_vps'
---
*Andere Wege Yunohost zu installieren findest Du **[hier](/install)**.*
### Vorraussetzungen
![](image://vps.png?resize=250)
* Ein dedizierter (Root-Server) oder virtueller privater Server (VPS)
* mit mindestens **512MB** RAM
* und **Debian 10.x (Buster) 64bits** als Betriebssystem
---
## Installationsschritte
[div class="btn btn-lg btn-default"] [1. Manuelle Installation](/install_manually) [/div]
[div class="btn btn-lg btn-default"] [2. Weiter mit der Erstkonfiguration (nach der Installation)](/postinstall) [/div]

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

@ -1,27 +0,0 @@
---
title: Instalación en un servidor dedicado
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_vps'
---
*Encontrar otros medios de instalar YunoHost **[aquí](/install)**.*
## Prerrequisitos
![](image://vps.png?resize=250)
* Un servidor dedicado o virtual
* con al menos **512MB** RAM
* y **Debian 10.x (Buster) 64bits** como sistema operativo
---
## Etapas de instalación
[div class="btn btn-lg btn-default"] [1. Instalar manualmente](/install_manually) [/div]
[div class="btn btn-lg btn-default"] [2. Post-instalación](/postinstall) [/div]

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

@ -1,26 +0,0 @@
---
title: Installation sur un serveur dédié
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_vps'
---
*Trouvez d’autres moyens d’installer YunoHost **[ici](/install)**.*
## Prérequis
![](image://vps.png?resize=250)
* Un serveur dédié ou virtuel
* avec au moins **512MB** RAM
* et **Debian 10.x (Buster) 64bits** comme système d'exploitation
---
## Étapes d’installation
[div class="btn btn-lg btn-default"] [1. Installer manuellement](/install_manually) [/div]
[div class="btn btn-lg btn-default"] [2. Effectuer la configuration initiale (post-installation)](/postinstall) [/div]

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

@ -1,27 +0,0 @@
---
title: Installa su un server dedicato
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_vps'
---
*Scopri altri modi di installare YunoHost **[qui](/install)**.*
### Pre-requisiti
![](image://vps.png?resize=250)
* Un server dedicato o un server privato virtuale (VPS)
* con almeno **512MB** di RAM
* e **Debian 10.x (Buster) 64bits** come sistema operativo
---
## Procedura di installazione
[div class="btn btn-lg btn-default"] [1. Installa manualmente](/install_manually) [/div]
[div class="btn btn-lg btn-default"] [2. Post-installazione](/postinstall) [/div]

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

@ -1,26 +0,0 @@
---
title: Install on a dedicated server
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_vps'
---
*Find other ways to install YunoHost **[here](/install)**.*
### Pre-requisite
![VPS](image://vps.png?resize=250)
* A dedicated or virtual private server
* with at least **512MB** RAM
* and **Debian 10.x (Buster) 64bits** as operating system
---
## Installation steps
[1. Install manually](/administrate/install/manualinstall?classes=btn,btn-lg,btn-primary)
[2. Proceed with the initial configuration (post-installation)](/administrate/postinstall?classes=btn,btn-lg,btn-primary)

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

@ -1,26 +0,0 @@
---
title: YunoHost manuell installieren
template: docs
taxonomy:
category: docs
routes:
default: '/install_manually'
---
!!! Dieser Vorgang funktioniert nur unter **Debian 10** <small>(mit **kernel >= 3.12**)</small>)
Sobald Du Zugriff auf die Kommandozeile auf Deinem Server hast (entweder direkt oder über SSH), kannst Du yunohost installieren, in dem Du das folgende Kommando als root ausführst:
```bash
curl https://install.yunohost.org | bash
```
<small>*(Falls `curl` noch nicht auf Deinem System installiert ist, musst Du es eventuell mit `apt install curl` installieren. Falls das Kommando fehlschlägt, ist eventuell ein `apt install ca-certificates` notwendig.)*</small>
Sobald die Installation abgeschlossen ist, fahre mit der [**Postinstallation**](/postinstall) fort.
---
**Anmerkung für forgeschrittene Benutzer mit Sorge gegenüber dem `curl|bash` Ansatz**
Falls Du stark gegen den `curl|bash` Weg (und ähnlicher Kommandos) zum installieren von Software eingestellt bist, empfehlen wir, ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) auf dem Sandstom Blog, und vielleicht [diese Diskussion auf Hacker News](https://news.ycombinator.com/item?id=12766350) zu lesen (beides Englisch).

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

@ -1,27 +0,0 @@
---
title: Instalar YunoHost manualmente
template: docs
taxonomy:
category: docs
routes:
default: '/install_manually'
---
!!! This procedure only works on **Debian 10** machines <small>(with **kernel >= 3.12**)</small>)
Una vez que tienes acceso a tu servidor (directamente o con SSH), puedes instalar YunoHost ejecutando este comando como root :
```bash
curl https://install.yunohost.org | bash
```
<small>*(Si `curl` no está instalado en tu sistema, tal vez tendrás que instalarlo con `apt install curl`. De otro modo, si el comando no muestra nada, puedes intentar `apt install ca-certificates`)*</small>
Cuando la instalación esté terminada, habrá que [**proceder a la post-instalación**](/postinstall)
---
**Nota para los usuarios expertos preocupados por el enfoque `curl|bash`**
Si no te gusta utilizar `curl|bash` (ou comandos similares) para desplegar software, toma el tiempo de leer ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) en el blog de Sandstorm, y también [esta discusión en Hacker News](https://news.ycombinator.com/item?id=12766350).

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

@ -1,27 +0,0 @@
---
title: Installer YunoHost manuellement
template: docs
taxonomy:
category: docs
routes:
default: '/install_manually'
---
!!! Cette procédure fonctionne seulement sur des machines avec **Debian 10** <small>(et **kernel >= 3.12**)</small>)
Une fois que vous avez accès à votre serveur (directement ou par SSH), vous pouvez installer YunoHost en exécutant cette commande en tant que root :
```bash
curl https://install.yunohost.org | bash
```
<small>*(Si `curl` n'est pas installé sur votre système, il vous faudra peut-être l'installer avec `apt install curl`. Autrement, si la commande n'affiche rien du tout, vous pouvez tenter `apt install ca-certificates`)*</small>
Une fois l'installation terminée, il vous faudra [**procéder à la post-installation**](/postinstall)
---
**Note pour les utilisateurs avancés inquiets à propos de l'approche `curl|bash`**
Si vous êtes suspicieux de la tendance à utiliser `curl|bash` (ou commandes similaires) pour déployer des logiciels, prenez le temps de lire ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) sur le blog de Sandstorm, et possiblement [cette discussion sur Hacker News](https://news.ycombinator.com/item?id=12766350).

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

@ -1,27 +0,0 @@
---
title: Installing YunoHost manually
template: docs
taxonomy:
category: docs
routes:
default: '/install_manually'
---
! 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 :
```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`
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).

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

@ -1,57 +0,0 @@
---
title: YunoHost auf einem Raspberry Pi installieren
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_raspberry'
---
*Alle Arten YunoHost zu installieren findest du **[hier](/install)**.*
![](image://raspberrypi.jpg?resize=300)
![](image://micro-sd-card.jpg)
!!! Vor der Einrichtung eines Servers zuhause ist es empfehlenswert [mögliche Einschränkungen deines Providers](/isp) zu kennen. Wenn er zu viele Einschränkungen vornimmt, kann es sinnvoll sein ein VPN zu nutzen um diese zum umgehen.
## Voraussetzungen
- Einen Raspberry Pi 2, 3 oder 4 (RPi 0 and 1 may work but require some tweaking ... see [this issue](https://github.com/YunoHost/issues/issues/1423)) ;
- Eine microSD Karte: **8 GB** Speicherplatz (mindestens) und **Class 10** Geschwindigkeit werden empfohlen (wie zum Beispiel die [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ;
- Ein Netzeil (entweder ein Steckernetzteil oder ein MicroUSB Kabel) ;
- An Netzwerkkabel (RJ-45) um den Raspberry mit dem router zu verbinden. (Raspberry Pi Zero Nutzer können ein OTG Kabel nutzen, [Wifi dongle](https://core-electronics.com.au/tutorials/raspberry-pi-zerow-headless-wifi-setup.html).) ;
- Einen [geeigneten Provider](/isp), am Besten einen mit einer guten upload Geschwindigkeit.
---
## Install with the pre-installed image (recommended)
[div class="btn btn-lg btn-default"] [0. Download the pre-installed image for Raspberry Pi](/images) [/div]
[div class="btn btn-lg btn-default"] [1. Flash the SD card with the image](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [2. Boot the board and connect to the web interface at `yunohost.local`](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [4. Proceed to post-installation](/postinstall) [/div]
---
## 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.
! The latest Raspberry Pi OS Lite 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/)).
1. Connect to your Raspberry Pi with the user `pi`. Set the root password with
```bash
sudo passwd root
```
2. Edit `/etc/ssh/sshd_config` to allow SSH login for root, by replacing `PermitRootLogin without-password` with `PermitRootLogin yes`. Reload the SSH daemon with `service ssh reload`.
3. Disconnect and reconnect, this time as root.
4. Then follow the <a href="/install_manually">generic manual install procedure</a>.

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

@ -1,57 +0,0 @@
---
title: Instalar YunoHost en un Raspberry Pi
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_raspberry'
---
*Encontrar otros medios de instalar YunoHost **[aquí](/install)**.*
![](image://raspberrypi.jpg?resize=300)
![](image://micro-sd-card.jpg)
!!! Antes de alojar tu propio servidor en tu casa, te recomendamos que consultes las [posibles restricciones impuestas por tu Proveedor de Internet](/isp). Si tu proveedor es demasiado restrictivo, puedes utilizar un VPN para eludir estas restricciones.
## Prerrequisitos
- Un Raspberry Pi 2, 3 o 4 (RPi 0 and 1 may work but require some tweaking ... see [this issue](https://github.com/YunoHost/issues/issues/1423)) ; ;
- Un adaptador de corriente para alimentar la tarjeta ;
- Una tarjeta microSD : al menos **8 Go** y **Clase 10** (por ejemplo una [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ;
- Un cable ethernet/RJ-45 para conectar la tarjeta con tu enrutador o tu caja internet. (Con el Raspberry Pi 0, puedes conectar tu tarjeta con un cable OTG y un adaptador Wifi USB.)
- Un [proveedor de Internet ético](/isp), de preferencia con buena velocidad de upload.
---
## Instalación con la imagen pre-instalada (recomendada)
[div class="btn btn-lg btn-default"] [1. Descargar la imagen para Raspberry Pi](/images) [/div]
[div class="btn btn-lg btn-default"] [2. Poner la imagen en tu tarjeta SD](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [3. Conectar y encender](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [4. Proceder a la post-instalación](/postinstall) [/div]
---
## Instalación manual (desaconsejada)
! No recomendamos la instalación manual porque es más técnica y más larga que la instalación vía la imagen per-instalada. Esta documentación sobre todo está destinada a los usuarios expertos.
! Las últimas versiones de Raspberry Pi OS necesitan una pantalla y un teclado porque ya no es posible conectarse directamente por SSH al Raspberry por defecto. Sin embargo, es posible reactivar el inicio de SSH al boot : solo hay que poner un archivo llamado `ssh` (vacío, sin extensión) en la partición boot de la tarjeta SD.
0. Instalar Raspberry Pi OS Lite ([instrucciones](https://www.raspberrypi.org/downloads/raspberry-pi-os/)) en la tarjeta SD.
1. Conéctate con SSH al Raspberry Pi con el usuario pi. Define una contraseña root con
```bash
sudo passwd root
```
2. Modifica `/etc/ssh/sshd_config` para autorizar root a que se conecte con ssh, reemplazando `PermitRootLogin without-password` por `PermitRootLogin yes`. Recarga el daemon ssh con `service ssh reload`, y luego re-conéctate como root.
3. Desconéctate et reconéctate con el usuario root esta vez.
4. Sigue con el <a href="/install_manually">procedimiento de instalación manual genérico</a>.

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

@ -1,58 +0,0 @@
---
title: Installer YunoHost sur Raspberry Pi
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_raspberry'
---
*Toutes les autres façons d’installer YunoHost sont listées **[ici](/install)**.*
![](image://raspberrypi.jpg?resize=300)
![](image://micro-sd-card.jpg)
!!! Avant d'héberger un serveur chez vous, il est recommandé de prendre connaissance des [possibles limitations liées à votre FAI](/isp). Si votre FAI est trop contraignant, vous pouvez envisager d'utiliser un VPN pour contourner ces limitations.
## Prérequis
- Un Raspberry Pi 2, 3 ou 4 (Les RPi 0 et 1 peuvent fonctionner mais nécessitent de bricoler un peu ... voir [cette issue](https://github.com/YunoHost/issues/issues/1423)) ;
- Un adaptateur secteur pour alimenter la carte ;
- Une carte microSD : au moins **8 Go** et **Classe 10** (par exemple une [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ;
- Un câble ethernet/RJ-45 pour brancher la carte à votre routeur/box internet. (Avec le Raspberry Pi 0, vous pouvez connecter votre carte avec un câble OTG et un adaptateur Wifi USB.)
- Un [fournisseur d’accès correct](/isp), de préférence avec une bonne vitesse d’upload.
---
## Installation avec l'image pré-installée (recommandée)
[div class="btn btn-lg btn-default"] [1. Télécharger l'image pour Raspberry Pi](/images) [/div]
[div class="btn btn-lg btn-default"] [2. Flasher la carte SD avec l'image](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [3. Démarrer la carte et se connecter à l'interface web sur `yunohost.local`](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [4. Effectuer la configuration initiale (post-installation)](/postinstall) [/div]
---
## Installation manuelle (déconseillée)
! Nous déconseillons l'installation manuelle car elle est plus technique et plus longue que l'installation via l'image pré-installée. Cette documentation est surtout destinée aux utilisateurs avancés.
! Les dernières versions de Raspbian nécessitent un écran et un clavier, car il n'est plus possible de se connecter directement en SSH au Raspberry par défaut. Néanmoins, il est possible de réactiver le lancement de SSH au boot : il suffit de placer dans la partition boot de la carte SD un fichier nommé `ssh`, vide et sans extension.
0. Installez Raspberry Pi OS Lite ([instructions](https://www.raspberrypi.org/downloads/raspberry-pi-os/)) sur la carte SD.
Le lien vers Raspberry Pi OS Lite est ici : https://downloads.raspberrypi.org/raspbian_lite/images/
1. Connectez-vous en SSH au Raspberry Pi avec l'utilisateur pi. Définissez un mot de passe root avec
```bash
sudo passwd root
```
2. Modifiez `/etc/ssh/sshd_config` pour autoriser root à se logger en SSH, en remplaçant `PermitRootLogin without-password` par `PermitRootLogin yes`. Rechargez le daemon SSH avec `service ssh reload`, puis re-connectez-vous en root.
3. Déconnectez-vous et reconnectez-vous avec l'utilisateur root cette fois.
4. Poursuivez avec la <a href="/install_manually">procédure d'installation manuelle générique</a>.

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

@ -1,60 +0,0 @@
---
title: Install YunoHost on a Raspberry Pi
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_raspberry'
---
*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](/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));
- 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);
- 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.
---
## Install with the pre-installed image (recommended)
[div class="btn btn-lg btn-default"] [0. Download the pre-installed image for Raspberry Pi](/images) [/div]
[div class="btn btn-lg btn-default"] [1. Flash the SD card with the image](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [2. Boot the board and connect to the web interface at `yunohost.local`](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [3. Proceed with the initial configuration (post-installation)](/postinstall) [/div]
---
## 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.
! 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/
1. Connect to your Raspberry Pi with the user `pi`. Set the root password with
```bash
sudo passwd root
```
2. Edit `/etc/ssh/sshd_config` to allow SSH login for root, by replacing `PermitRootLogin without-password` with `PermitRootLogin yes`. Reload the SSH daemon with `service ssh reload`.
3. Disconnect and reconnect, this time as root.
4. Then follow the <a href="/install_manually">generic manual install procedure</a>.

50
pages/01.administrate/02.install/05.arm/install_on_arm_board.es.md
View file

@ -1,50 +0,0 @@
---
title: Instalar YunoHost en una tarjeta ARM
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_arm_board'
---
*Encontrar otros medios de instalar YunoHost **[aquí](/install)**.*
![](image://olinuxino.jpg?resize=250)
![](image://micro-sd-card.jpg)
!!! Antes de alojar tu propio servidor en tu casa, te recomendamos que consultes las [posibles restricciones impuestas por tu Proveedor de Internet](/isp). Si tu proveedor es demasiado restrictivo, puedes utilizar un VPN para eludir estas restricciones.
- Una tarjeta ARM con un procesador de 500 MHz et 512 Mo de memoria RAM ;
- Un adaptador de corriente para alimentar la tarjeta ;
- Una tarjeta microSD : al menos **8 Go** y **Clase 10** (por ejemplo una [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ;
- Un cable ethernet/RJ-45 para conectar la carte con el router / caja internet. (Con el Raspberry Pi 0, puedes conectar tu tarjeta con un cable OTG y un adaptador Wifi USB.)
- Un [proveedor de Internet ético](/isp), de preferencia con una buena velocidad de upload.
---
## Instalación con la imagen pre-instalada (recomendada)
[div class="btn btn-lg btn-default"] [0. Descargar la imagen pre-instalada para tu tarjeta ARM](/images) [/div]
<br>
<small class="text-info">Si no existe una imagen dedicada a tu tarjeta, puedes seguir la sección "Instalación encima de ARMbian".</small>
[div class="btn btn-lg btn-default"] [1. Poner la imagen en tu tarjeta SD](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [2. Conectar y encender](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [3. Proceder a la post-instalación](/postinstall) [/div]
---
## Instalación encima de ARMbian
[div class="btn btn-lg btn-default"] [0. Descargar la imagen ARMbian para tu tarjeta ARM](https://www.armbian.com/download/) [/div]
[div class="btn btn-lg btn-default"] [1. Poner la imagen en tu tarjeta SD](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [2. Conectar y encender](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [3. Conectarse en SSH](/ssh) [/div]
[div class="btn btn-lg btn-default"] [4. Proceder a la post-instalación genérica](/install_manually) [/div]

50
pages/01.administrate/02.install/05.arm/install_on_arm_board.fr.md
View file

@ -1,50 +0,0 @@
---
title: Installer YunoHost sur carte ARM
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_arm_board'
---
*Toutes les autres façons d’installer YunoHost sont listées **[ici](/install)**.*
![](image://olinuxino.jpg?resize=250)
![](image://micro-sd-card.jpg)
!!! Avant d'héberger un serveur chez vous, il est recommandé de prendre connaissance des [possibles limitations liées à votre FAI](/isp). Si votre FAI est trop contraignant, vous pouvez envisager d'utiliser un VPN pour contourner ces limitations.
- Une carte ARM avec un processeur de 500 MHz et 512 Mo de mémoire vive ;
- Un adaptateur secteur pour alimenter la carte ;
- Une carte microSD : au moins **8 Go** et **Classe 10** (par exemple une [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ;
- Un câble ethernet/RJ-45 pour brancher la carte à votre routeur/box internet. (Avec le Raspberry Pi 0, vous pouvez connecter votre carte avec un câble OTG et un adaptateur Wifi USB.)
- Un [fournisseur d’accès correct](/isp), de préférence avec une bonne vitesse d’upload.
---
## Installation avec l'image pré-installée (recommandée)
[div class="btn btn-lg btn-default"] [0. Télécharger l'image pré-installée pour votre carte ARM](/images) [/div]
<br>
<small class="text-info">Si il n'existe pas d'image pré-installée pour votre carte, vous pouvez suivre la section "Installation par dessus ARMbian".</small>
[div class="btn btn-lg btn-default"] [1. Flasher la carte SD avec l'image](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [2. Démarrer la carte et se connecter à l'interface web sur `yunohost.local`](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [3. Effectuer la configuration initiale (post-installation)](/postinstall) [/div]
---
## Installation par dessus ARMbian
[div class="btn btn-lg btn-default"] [0. Télécharger l'image ARMbian pour votre carte ARM](https://www.armbian.com/download/) [/div]
[div class="btn btn-lg btn-default"] [1. Flasher la carte SD avec l'image](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [2. Brancher & démarrer](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [3. Se connecter en SSH](/ssh) [/div]
[div class="btn btn-lg btn-default"] [4. Suivre la procédure d'installation générique](/install_manually) [/div]

51
pages/01.administrate/02.install/05.arm/install_on_arm_board.md
View file

@ -1,51 +0,0 @@
---
title: Install YunoHost on ARM board
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_arm_board'
---
*Find other ways to install YunoHost **[here](/install)**.*
![](image://olinuxino.jpg?resize=250)
![](image://micro-sd-card.jpg)
!!! 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.
## Pre-requisites
- An ARM board with 500MHz CPU and 512 MB of RAM;
- A power supply for your board;
- A 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 ethernet cable (RJ-45) to connect your board to your router;
- A [reasonable ISP](/isp), preferably with a good and unlimited upload bandwidth.
---
## Install with the pre-installed image (recommended)
[div class="btn btn-lg btn-default"] [0. Download the pre-installed image for your board](/images) [/div]
<br>
<small class="text-info">If no pre-installed image exists for your board, you can follow the instructions to "Install on top of ARMbian"</small>
[div class="btn btn-lg btn-default"] [1. Flash the SD card with the image](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [2. Boot the board and connect to the web interface at `yunohost.local`](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [3. Proceed with the initial configuration (post-installation)](/postinstall) [/div]
---
## Install on top of ARMbian
[div class="btn btn-lg btn-default"] [0. Download the ARMbian image for your board](https://www.armbian.com/download/) [/div]
[div class="btn btn-lg btn-default"] [1. Flash the SD card with the image](/burn_or_copy_iso) [/div]
[div class="btn btn-lg btn-default"] [2. Plug & boot](/plug_and_boot) [/div]
[div class="btn btn-lg btn-default"] [3. Connect to your server with SSH](/ssh) [/div]
[div class="btn btn-lg btn-default"] [4. Follow the generic install procedure](/install_manually) [/div]

31
pages/01.administrate/02.install/06.debian/install_on_debian.ar.md
View file

@ -1,31 +0,0 @@
---
title: التنصيب على ديبيان
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_debian'
---
<div dir="RTL" align="right" style="direction:rtl;text-align:right;">
*يمكنكم الإطلاع على طُرق أخرى لتنصيب واي يونوهوست YunoHost **[هنا](/install)**.*
## المتطلبات
![](image://debian-logo.png?resize=100)
على منصة ARM أو على خادوم إفتراضي خاص أو على خادوم إستضافة أو على حاسوب x86 عادي أو على حاسوب ماكينطوش قديم … إلخ
* على **ديبيان 8** (جيسي) قد تم تنصيبه مِن قبل
* مُتصل بالإنترنت عبر كابل إيثرنت
* مباشرة عبر **النفاذ بالمستخدم الجذري root** أو عبر الـ SSH
---
## خطوات التنصيب
[div class="btn btn-lg btn-default"] [1. التنصيب يدويًا](/install_manually) [/div]
[div class="btn btn-lg btn-default"] [2. ما بعد التنصيب](/postinstall) [/div]

31
pages/01.administrate/02.install/06.debian/install_on_debian.fr.md
View file

@ -1,31 +0,0 @@
---
title: Installation sur Debian
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_debian'
---
*Trouvez d’autres moyens d’installer YunoHost **[ici](/install)**.*
## Prérequis
![](image://debian-logo.png?resize=100)
Sur une plateforme ARM, un VPS, un serveur dédié, un ordinateur x86 standard, un vieux Macintosh,...
* avec **Debian 10** (Buster) installé <small>(avec un kernel >= 3.12)</small>
* l'ISO Debian 10 ISO peut être téléchargée depuis [cette page](https://www.debian.org/releases/buster/debian-installer/). Prenez la 'netinst CD image' pour votre architecture
* N.B. : Avoir un environnement graphique n'est *pas* recommandé ! Les serveurs sont généralement administrés à distance !
* connecté à Internet
* avec un **accès root** directement ou par SSH
---
## Étapes d’installation
[div class="btn btn-lg btn-default"] [1. Installer manuellement](/install_manually) [/div]
[div class="btn btn-lg btn-default"] [2. Post-installation](/postinstall) [/div]

30
pages/01.administrate/02.install/06.debian/install_on_debian.it.md
View file

@ -1,30 +0,0 @@
---
title: Installazione su Debian
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_debian'
---
*Altri sistemi per installare Debian **[qui](/install)**.*
### Requisiti
![](image://debian-logo.png?resize=100)
Su un computer ARM, un VPS, un server dedicato, un computer x86 standard, un vecchio Macintosh, ...
* con **Debian 10** (Buster) installato <small>(con un kernel >= 3.12)</small>
* l'immagine ISO di Debian 10 può essere scaricata da [qui](https://www.debian.org/releases/buster/debian-installer/). Scegli l'immagine 'netinst CD' per la tua architettura.
* N.B.: l'uso di un'interfaccia grafica *non* è raccomandato! I server dovrebbero essere amministrati da remoto!
* connesso ad Internet
* con un **accesso root** diretto o via SSH
---
## Passi per l'installazione
[div class="btn btn-lg btn-default"] [1. Installazione manuale](/install_manually) [/div]
[div class="btn btn-lg btn-default"] [2. Post-installazione](/postinstall) [/div]

31
pages/01.administrate/02.install/06.debian/install_on_debian.md
View file

@ -1,31 +0,0 @@
---
title: Installation on Debian
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_debian'
---
*Find other ways to install YunoHost **[here](/install)**.*
### Requirements
![](image://debian-logo.png?resize=100)
An ARM box, a VPS, a dedicated server, a standard x86 computer, an old Macintosh, ...
* with **Debian 10** (Buster) installed <small>(with kernel >= 3.12)</small>
* the Debian 10 ISO can be downloaded from [here](https://www.debian.org/releases/buster/debian-installer/). Take the 'netinst CD image' for your architecture.
* N.B. : having a graphical environment is *not* recommended! Servers are meant to be administrated remotely!
* connected to the Internet
* with a direct **root access** or via SSH
---
## Installation steps
[div class="btn btn-lg btn-default"] [1. Install manually](/install_manually) [/div]
[div class="btn btn-lg btn-default"] [2. Post-install](/postinstall) [/div]

81
pages/01.administrate/02.install/07.virtualbox/install_on_virtualbox.es.md
View file

@ -1,81 +0,0 @@
---
title: Instalar YunoHost en VirtualBox
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_virtualbox'
---
*Encontrar otros medios de instalar YunoHost **[aquí](/install)**.*
## Prerrequisitos
![](image://virtualbox.png?resize=200)
* Un ordenador x86 con VirtualBox instalado y bastante RAM disponible para iniciar una pequeña máquina virtual.
* La última **imagen ISO YunoHost** estable, disponible [aquí](/images).
! N.B. : Instalar YunoHost en VirtualBox es útil para probar la distribución. Para realmente autoalojarse a largo plazo, probablement necesitarás una máquina virtual (viejo ordenador, tarjeta ARM...) o un VPS.
---
## <small>1.</small> Crear una nueva máquina virtual
![](image://virtualbox_1.png)
<br>
* No es grave si sólo la versión 32-bit está disponible, pero en este caso asegúrate que 32 bit previamente.
* 256Mo de RAM es el requisito mínimo, 512Mo está recomendado (1Go o más si puedes).
* 8Go de almacenaje mínimo requisito.
---
## <small>2.</small> Modificar la configuración de la red
Ir a **Settings** > **Network** :
![](image://virtualbox_2.png)
<br>
* Selectiona `Bridged adapter`
* Elige tu interfaz según su nombre :
**wlan0** si estás conectado sin hilo, **eth0** de otro modo.
---
## <small>3.</small> Inicia tu máquina virtual
Inicia tu máquina virtual
![](image://virtualbox_2.1.png)
<br>
Aquí tienes que seleccionar la imagen ISO, luego deberías ver esta pantalla de bienvenida.
<br>
Si te encuentras con el error "VT-x is not available", probablement hay que activar (enable) la virtualización en la opciones del BIOS de tu ordenador.
<br>
![](image://virtualbox_3.png)
<br>
* Elige `Instalación gráfica`
* Selecciona tu idioma, tu ubicación, la distribución de tu teclado y deja el ordenador terminar el proceso :-)
---
## <small>4.</small> Efectuar la post-instalación
Después del reinicio, la máquina debería proponerte de efectuar la post-instalación :
[div class="btn btn-lg btn-default"] [Documentación de post-instalación](/postinstall) [/div]

82
pages/01.administrate/02.install/07.virtualbox/install_on_virtualbox.fr.md
View file

@ -1,82 +0,0 @@
---
title: Installer YunoHost sur VirtualBox
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_virtualbox'
---
*Trouvez d’autres moyens d’installer YunoHost **[ici](/install)**.*
## Prérequis
![](image://virtualbox.png?resize=200)
* Un ordinateur x86 avec VirtualBox installé et assez de RAM disponible pour lancer une petite machine virtuelle.
* La dernière **image ISO YunoHost** stable, disponible [ici](/images).
! N.B. : Installer YunoHost dans une VirtualBox est utile pour tester la distribution. Pour réellement s'autohéberger sur le long terme, il vous faudra probablement une machine physique (vieil ordinateur, carte ARM...) ou un VPS en ligne.
---
## <small>1.</small> Créer une nouvelle machine virtuelle
![](image://virtualbox_1.png)
<br>
* Ce n'est pas grave si seulement la version 32-bit est dispo, mais dans ce cas soyez sur d'avoir téléchargé l'image 32 bit précédemment.
* 256Mo de RAM est le minimum requis, 512Mo est recommandé (1Go ou plus si vous pouvez).
* 8Go de stockage minimum requis pour le système, y ajouter l'espace pour vos applications.
---
## <small>2.</small> Modifier la configuration réseau
Allez dans **Réglages** > **Réseau** :
![](image://virtualbox_2.png)
<br>
* Sélectionnez `Accès par pont`
* Choisissez votre interface selon son nom :
**wlan0** si vous êtes connecté sans-fil, **eth0** sinon.
---
## <small>3.</small> Lancer votre machine virtuelle
Démarrez votre machine virtuelle
![](image://virtualbox_2.1.png)
<br>
Vous devez sélectionner ici l’image ISO, puis vous devriez voir cet écran d’accueil YunoHost.
<br>
Si vous rencontrez l'erreur "VT-x is not available", il vous faut probablement activer (enable) la virtualisation dans les options du BIOS de votre ordinateur.
<br>
![](image://virtualbox_3.png)
<br>
* Choisissez `Installation graphique`
* Sélectionnez votre langue, votre emplacement, la disposition de votre clavier et laissez l’installeur faire le reste :-)
---
## <small>4.</small> Effectuer la post-installation
Après le redémarrage, la machine devrait vous proposer d'effectuer la
post-installation :
[div class="btn btn-lg btn-default"] [Documentation de la postinstall](/postinstall) [/div]

87
pages/01.administrate/02.install/07.virtualbox/install_on_virtualbox.md
View file

@ -1,87 +0,0 @@
---
title: Install YunoHost on VitualBox
template: docs
taxonomy:
category: docs
routes:
default: '/install_on_virtualbox'
---
*Find other ways to install YunoHost **[here](/install)**.*
## Requirements
![](image://virtualbox.png?resize=200)
* An x86 computer with VirtualBox installed and enough RAM capacity to be able to run a small virtual machine.
* The latest stable **YunoHost ISO image**, available [here](/images).
! N.B. : Installing YunoHost in a VirtualBox is usually intended for testing. To run an actual server on the long-term, you usually need a dedicated physical machine (old computer, ARM board...) or a VPS online.
---
## <small>1.</small> Create a new virtual machine
![](image://virtualbox_1.png)
<br>
* It's okay if you can only have 32-bit versions, just be sure that you downloaded the 32-bit image previously.
* 256MB RAM is the minimum required, but at least 512MB is recommended (1Go or more if you can).
* 8GB storage is the minimum required for the system, add whatever is necessary for your apps.
---
## <small>2.</small> Change network settings
**NB:** You must carry out this step. If not, the install will fail.
Go to **Settings** > **Network**:
![](image://virtualbox_2.png)
<br>
* Select `Bridged adapter`
* Select your interface's name:
**wlan0** if you are connected wirelessly, else **eth0**.
---
## <small>3.</small> Boot up the virtual machine
Start the virtual machine
![](image://virtualbox_2.1.png)
<br>
You will have to select your ISO image here, then you should see the YunoHost's boot screen.
<br>
If you encounter the error "VT-x is not available", you need probably need to enable Virtualization in the BIOS of your computer.
<br>
![](image://virtualbox_3.png)
<br>
* Select `Graphical install`
* Select your language, your location, your keyboard layout and let the installer do the rest :-)
---
## <small>4.</small> Proceed to post-installation
After the reboot, the system should ask you to proceed with the
post-installation
[div class="btn btn-lg btn-default"] [Post-install documentation](/postinstall) [/div]

24
pages/01.administrate/02.install/08.plugandboot/plug_and_boot.es.md
View file

@ -1,24 +0,0 @@
---
title: Conectar e iniciar el servidor
template: docs
taxonomy:
category: docs
routes:
default: '/plug_and_boot'
---
* Conecta tu servidor con un cable Ethernet (RJ-45) **directamente sobre tu router principal**. También puedes configurar la conexión wifi como explicado [aquí (fr)](http://raspbian-france.fr/connecter-wifi-raspberry-pi-3/). El wifi también puede configurarse sin haber iniciado la tarjeta, "montando" la segunda partición de la tarjeta y finalmente editando el archivo wpa-supplicant.conf. En Windows, puedes utilizar [Paragon ExtFS](https://www.paragon-software.com/home/extfs-windows/), no olvides de "unmount" para que los cambios estén integrados.
* No te olvides de **conectar una pantalla** si quieres observar cómo ocurre el inicio, y un teclado si quieres un acceso con **línea de comandos** a tu servidor.
* Inicia el servidor, el Raspberry Pi va a reiniciarse si-mismo una primera vez, pues espera hasta que veas un gran `Y` cuadrado :
<br>
![](image://boot_screen.png)
<p markdown="1">
*Nota el valor `IP` visible en la pantalla : esto es **la dirección IP local** de tu servidor.*
</p>
</div>

36
pages/01.administrate/02.install/08.plugandboot/plug_and_boot.fr.md
View file

@ -1,36 +0,0 @@
---
title: Brancher et démarrer votre serveur
template: docs
taxonomy:
category: docs
routes:
default: '/plug_and_boot'
---
* Mettez la carte SD dans le serveur (pour le cas des cartes ARM)
* Branchez le cable ethernet
* Branchez l'alimentation
* Laissez quelques minutes à votre serveur pour démarrer
### Se connecter à son serveur
* Assurez vous que votre ordianteur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box internet) que votre serveur.
* Ouvrez un navigateur internet et tapez `https://yunohost.local` dans la barre d'adresse.
* Si votre serveur est actif, vous rencontrerez très probablement un avertissement de sécurité. Cet avertissement viens du fait que votre serveur utilise pour le moment ce qui s'appelle un "certificat auto-signé" - et que nous utisons un domaine spécial en `.local`. Vous pourrez plus tard ajouter 'vrai' domaine et un certificat automatiquement reconnus par les navigateurs comme décrit dans la page sur les [Certificats](/certificate). En attendant, ajoutez une exception de sécurité pour accepter le certificat actuel.
* Si vous n'arrivez pas à contacter votre serveur avec `yunohost.local`, essayez de [trouver l'IP locale de votre serveur](/finding_the_local_ip) - puis dans la barre d'adresse de votre navigateur, tapez `https://192.168.x.y`
* [Effectuer la configuration initiale (post-installation)](/postinstall)
---
#### [Optionnel] Connecter le serveur à internet en WiFi
* Vous pouvez aussi configurer la connexion wifi comme expliqué [ici](http://raspbian-france.fr/connecter-wifi-raspberry-pi-3/).
* La configuration wifi peut aussi se faire sans avoir booté sur la carte, en "montant" la deuxième partition de la carte et enfin éditer le fichier `wpa-supplicant.conf`. Sur Windows vous pouvez utiliser [Paragon ExtFS](https://www.paragon-software.com/home/extfs-windows/). Ne pas oublier de "unmount" pour que les changements soient pris en compte.
---
#### [Optionnel] Accès direct avec un écran et clavier
* Il est possible de brancher un écran et clavier sur votre serveur pour vérifier que le processus de démarrage (boot) se passe bien et pour avoir un accès direct en console.
![](image://boot_screen.png)

38
pages/01.administrate/02.install/08.plugandboot/plug_and_boot.md
View file

@ -1,38 +0,0 @@
---
title: Plug and boot your server up
template: docs
taxonomy:
category: docs
routes:
default: '/plug_and_boot'
---
# Boot and connect to your server
* Plug the SD card (for ARM boards)
* Plug the ethernet cable
* Plug the power supply
* Wait a couple minutes for your server to boot
### Connecting to your server
* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
* Open a browser and type `https://yunohost.local` in the address bar.
* If your server is up, you will very likely encounter a security warning. This is because your server is for now using what's called a "self-signed certificate" - and because we're accessing the server through a special `.local` domain. You will later be able to add a proper domain and install a certificate automatically recognized by web browsers as described in the [certificate documentation](/certificate). In the meantime, you should add a security exception to accept the current certificate.
* If you are NOT able to join your server using the `yunohost.local` domain, try to [find the local IP of your server](/finding_the_local_ip) - then in your browser's address bar, type `https://192.168.x.y`
* [Proceed with the initial configuration (post-installation)](/postinstall)
---
#### [Optional] Connecting your server to the internet through WiFi
* If you want your server to connect using WiFi, you may configure it as explained [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
* Alternatively, you can mount the second partition of the SD card and edit the `wpa-supplicant.conf` file prior to boot the card for the first time. On Windows you can use [Paragon ExtFS](https://www.paragon-software.com/home/extfs-windows/) for this - just don't forget to unmount everytime for changes to take effect.
---
#### [Optional] Direct access with a screen and keyboard
You can also boot your server with a screen and keyboard connected to it to see how the boot process is going on (which can also be useful to troubleshoot issues) and to have a direct access to it.
![](image://boot_screen.png)

19
pages/01.administrate/02.install/09.docker/docker.fr.md
View file

@ -1,19 +0,0 @@
---
title: Docker et YunoHost
template: docs
taxonomy:
category: docs
routes:
default: '/docker'
---
!! **YunoHost ne supporte plus officiellement Docker depuis les problèmes rencontrés avec la version 2.4+. En cause, YunoHost dépend désormait de systemd et docker a décidé qu’ils ne le supporteraient pas nativement (et il y a d'autres problèmes liés au firewall et aux services).**
## Images communautaires
Cependant il existe des images communautaires disponibles sur Docker Hub :
* [AMD64 (classique) (YunoHost v4+)](https://hub.docker.com/r/domainelibre/yunohost/)
* [I386 (anciens pc) (YunoHost v4+)](https://hub.docker.com/r/domainelibre/yunohost-i386/)
* [ARMV7 (Raspberry Pi 2/3 ...) (YunoHost v4+)](https://hub.docker.com/r/domainelibre/yunohost-arm/)
* [ARMV6 (Raspberry Pi 1) (ancienne version de YunoHost)](https://hub.docker.com/r/tuxalex/yunohost-armv6/)

19
pages/01.administrate/02.install/09.docker/docker.md
View file

@ -1,19 +0,0 @@
---
title: Docker and YunoHost
template: docs
taxonomy:
category: docs
routes:
default: '/docker'
---
!! **YunoHost doesn’t support Docker officially since issues with versions 2.4+. In question, YunoHost 2.4+ doesn’t work anymore on Docker because YunoHost requires systemd and Docker has chosen to not support it natively (and there are other problems link to the firewall and services).**
## Community images
However, community images exist and are available on Docker Hub:
* [AMD64 (classic) (ancienne version de YunoHost)](https://hub.docker.com/r/domainelibre/yunohost/)
* [I386 (old computers) (ancienne version de YunoHost)](https://hub.docker.com/r/domainelibre/yunohost-i386/)
* [ARMV7 (Raspberry Pi 2/3 ...) (ancienne version de YunoHost)](https://hub.docker.com/r/domainelibre/yunohost-arm/)
* [ARMV6 (Raspberry Pi 1) (old yunoHost version)](https://hub.docker.com/r/tuxalex/yunohost-armv6/)

52
pages/01.administrate/02.install/11.burn_iso/burn_or_copy_iso.fr.md
View file

@ -1,52 +0,0 @@
---
title: Flasher l'ISO YunoHost
template: docs
taxonomy:
category: docs
routes:
default: '/burn_or_copy_iso'
---
Maintenant que vous avez téléchargé l’image ISO de YunoHost, vous devez la mettre sur un support physique. Classiquement, il s'agit d'une **Clé USB** ou d'une **Carte SD**.
![](image://sdcard.jpg?resize=100)
![](image://micro-sd-card.jpg?resize=100)
![](image://usb_key.png?resize=150)
![](image://cd.jpg?resize=100)
---
### (Recommandé) Avec Etcher
Téléchargez <a href="https://etcher.io/" target="_blank">Etcher</a> pour votre système d'exploitation et installez-le.
![](image://etcher.gif)
Branchez votre clef USB, selectionnez l'ISO YunoHost puis cliquez sur 'Flash'
### Avec UNetbootin
Téléchargez <a href="https://unetbootin.github.io/">UNetbootin</a> pour votre système d'exploitation et installez-le.
![](image://unetbootin.png)
Branchez votre clef USB, selectionnez l'ISO YunoHost puis cliquez sur 'OK'
### Avec `dd`
Si vous êtes familier avec la ligne de commande, il est possible de flasher la clef USB ou carte SD avec `dd`. Vous pouvez identifier le nom du périphérique avec `fdisk -l` ou `lsblk`. Une carte SD s'apelle typiquement `/dev/mmcblk0`. ATTENTION à faire attention de prendre le bon nom !
```bash
# Remplacer /dev/mmcblk0 par le nom de votre périphérique
dd if=/chemin/de/yunohost.iso of=/dev/mmcblk0
```
### CD/DVD
Pour les anciens matériels, il vous faut peut-être utiliser un CD/DVD. Le logiciel à utiliser est différent suivant votre système d’exploitation.
* Sur Windows, utilisez [ImgBurn](http://www.imgburn.com/) pour écrire l’image sur le disque
* Sur macOS, utilisez [Disk Utility](http://support.apple.com/kb/ph7025)
* Sur GNU/Linux, vous avez plusieurs choix, tels que [Brasero](https://wiki.gnome.org/Apps/Brasero) ou [K3b](http://www.k3b.org/)

59
pages/01.administrate/02.install/11.burn_iso/burn_or_copy_iso.md
View file

@ -1,59 +0,0 @@
---
title: Flashing the YunoHost ISO
template: docs
taxonomy:
category: docs
routes:
default: '/burn_or_copy_iso'
---
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 <a href="https://www.balena.io/etcher/" target="_blank">Etcher</a> 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"
### With UNetbootin
Download <a href="https://unetbootin.github.io/">UNetbootin</a> 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"
### With `dd`
If you are on GNU/Linux / macOS and know your way around command line, you may also flash your USB stick or SD card with `dd`. You can identify which device corresponds to your USB stick or SD card with `fdisk -l` or `lsblk`. A typical SD card name is something like `/dev/mmcblk0`. BE CAREFUL and make sure you got the right name.
Then run :
```bash
# Replace /dev/mmcblk0 if the name of your device is different...
dd if=/path/to/yunohost.img of=/dev/mmcblk0
```
### Burning a CD/DVD
For older devices, you might want to burn a CD/DVD. The software to use depends on your operating system.
* On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc
* On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025)
* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/)

56
pages/01.administrate/02.install/12.graphical_install/boot_and_graphical_install.fr.md
View file

@ -1,56 +0,0 @@
---
title: Installation graphique
template: docs
taxonomy:
category: docs
routes:
default: '/boot_and_graphical_install'
---
Maintenant que vous possédez un support YunoHost, vous pouvez procéder à l’installation.
## <small>1.</small> Brancher le câble réseau
Si vous souhaitez que la configuration réseau soit configurée automatiquement, vous devez brancher votre serveur avec un câble **Ethernet** directement **derrière votre routeur (ou box) principal**.
Les connexions sans-fil ne sont pas supportées pour le moment, et si vous utilisez des routeurs intermédiaires, l’ouverture des ports réseau ne se fera pas automatiquement : votre serveur ne sera pas accessible depuis l’extérieur.
## <small>2.</small> Démarrer sur le CD/la clé USB
Démarrez votre serveur avec la clé USB ou le CD-ROM inséré, et sélectionnez-le comme **périphérique de démarrage** en pressant l’une des touches suivantes (dépendant de votre ordinateur) :
```<Échap>```, ```<F9>```, ```<F10>```, ```<F11>```, ```<F12>``` or ```<Suppr>```
## <small>3.</small> Lancer l’installation graphique
Vous devriez voir un écran comme ça :
![](image://virtualbox_3.png)
* Sélectionnez `Graphical install`
* Sélectionnez votre langue, votre localisation et votre agencement de clavier.
* Si un écran de partitionnement apparaît, confirmez simplement.
!! **Attention** : Cette opération effacera totalement les données sur votre disque dur
* Laissez l’installateur faire le reste, il téléchargera les paquets requis et les installera.
!!! Si cette opération échoue, vous avez probablement un problème de connexion à Internet. Vérifiez que votre serveur est bien branché et réessayez.
* L’ordinateur devrait redémarrer automatiquement à la fin de l’installation.
## <small>4.</small> Log in
Après avoir redémarré, votre machine devrait afficher un écran noir avec
quelques mots vous invitant à vous identifier. Vous pouvez utiliser les
identifiants suivants :
* User: **root**
* Password: **yunohost**
## <small>5.</small> Procéder à la post-installation
[div class="btn btn-lg btn-default"] [Documentation de la post-installation](/postinstall) [/div]

52
pages/01.administrate/02.install/12.graphical_install/boot_and_graphical_install.md
View file

@ -1,52 +0,0 @@
---
title: Graphical installation
template: docs
taxonomy:
category: docs
routes:
default: '/boot_and_graphical_install'
---
Now that your YunoHost install medium, you can start with the installation.
## 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
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>```
## 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.
! If it fails, you probably have an Internet connection issue.
! Check that your computer is physically connected and retry.
5. It should reboot automatically.
## 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`
## 5. Proceed to post-installation
[div class="btn btn-lg btn-default"] [Post-install documentation](/administrate/postinstall) [/div]