Merge pull request #439 from YunoHost/update-install-doc

Update install documentation
This commit is contained in:
Alexandre Aubin 2017-01-31 00:37:06 +01:00 committed by GitHub
commit f64b8cbb17
19 changed files with 286 additions and 328 deletions

View file

@ -5,11 +5,21 @@
* [What is Self-hosting](/selfhosting)
* [Compatible hardware](/hardware)
* [Installation guide](/install)
* [On ARM board](/install_on_arm_board)
* [On Raspberry Pi](/install_on_raspberry)
* [From the ISO image](/install_iso)
* [On an OLinuXino board](/install_on_olinuxino)
* [On an ARM board](/install_on_arm_board)
* [On a Raspberry Pi](/install_on_raspberry)
* [From an ISO](/install_iso)
* [On Debian](/install_on_debian)
* [On VirtualBox](/install_on_virtualbox)
* [On Vagrant](/vagrant)
* [On a dedicated or a virtual private server](/install_on_vps)
* Installation steps
* [Burn or copy iso](/burn_or_copy_iso)
* [Boot and graphical install](/boot_and_graphical_install)
* [Copy YunoHost image on SD card](/copy_image)
* [Manual instalation](/install_manually)
* [Plug and boot your server](/plug_and_boot)
* [Post-instalation](/postinstall)
* [Available applications](/apps)
* [Administration interface usage](/admin)
* [Command-line interface usage](/moulinette)

View file

@ -3,15 +3,14 @@
* [Lauto-hébergement](/selfhosting_fr)
* [Matériel compatible](/hardware_fr)
* [Guide dinstallation](/install_fr)
* [Sur une carte OLinuXino](/install_on_olinuxino_fr)
* [Sur carte ARM](/install_on_arm_board_fr)
* [Sur Raspberry Pi](/install_on_raspberry_fr)
* [À partir de lISO](/install_iso_fr)
* [Sur Debian](/install_on_debian_fr)
* [Sur VirtualBox](/install_on_virtualbox_fr)
* [Sur Docker](/docker_fr)
* [Sur Vagrant](/vagrant_fr)
* [Sur un conteneur DigitalOcean](/install_on_digitalocean_fr)
* [Sur un serveur dédié](/install_on_dedicated_server_fr)
* [Sur un serveur dédié](/install_on_vps_fr)
* Étapes dinstallation
* [Graver ou copier lISO](/burn_or_copy_iso_fr)
* [Démarrage et installation graphique](/boot_and_graphical_install_fr)

BIN
images/computer.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 154 KiB

BIN
images/olinuxino.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 91 KiB

BIN
images/raspberrypi.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 61 KiB

View file

@ -10,14 +10,22 @@ This page lists a few installation guides.
<div class="row">
<div class="col col-md-3 text-center">
<a href="/try_at_home"><img src="/images/usb_key.png" height=150 style="vertical-align:bottom"><b><p>Live CD/USB</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/try"><img height=150 src="/images/logo.png" style="vertical-align:bottom"><b><p>Demo server</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/try_at_home"><img src="/images/usb_key.png" height=150 style="vertical-align:bottom"><b><p>Try with a Live USB</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_virtualbox"><img src="/images/virtualbox.png" height=150 style="vertical-align:bottom"><b><p>Try in VirtualBox</p></b></a>
</div>
</div>
</div>
@ -25,25 +33,43 @@ This page lists a few installation guides.
---
<h1 style="font-weight: 100">Install @ home</h1>
<h1 style="font-weight: 100">Install at home</h1>
<div class="row">
<div class="col col-md-3 text-center">
<a href="/installation_brique_fr"><img src="/images/thisisinternet.png" height=150 style="vertical-align:bottom"><b><p>On the Internet Cube</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_arm_board"><img src="/images/cubieboard2.png" height=150 style="vertical-align:bottom"><b><p>On an ARM board</p></b></a>
<a href="/install_on_olinuxino"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom"><b><p>On an OlinuXino (Internet Cube)</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_raspberry"><img src="/images/Raspberry_Pi_2_Model_B_v1.1_front_angle_new.jpg" height=150 style="vertical-align:bottom"><b><p>On a Raspberry Pi</p></b></a>
<a href="/install_on_raspberry"><img src="/images/raspberrypi.jpg" height=150 style="vertical-align:bottom"><b><p>On a Raspberry Pi</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_iso"><img src="/images/laptop.png" height=150 style="vertical-align:bottom"><b><p>On a standard computer</p></b></a>
<a href="/install_on_arm_board"><img src="/images/cubieboard2.png" height=150 style="vertical-align:bottom"><b><p>On an ARM board</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_iso"><img src="/images/computer.png" height=150 style="vertical-align:bottom"><b><p>On a regular computer</p></b></a>
</div>
</div>
<br>
---
<h1 style="font-weight: 100">Install on a remote server</h1>
<div class="alert alert-info" markdown="1">
<span class="glyphicon glyphicon-heart"></span> Local associative ISP near you might be able to provide you with a *Virtual Private Server* (VPS), managed by human beings who respect users and care about [Net Neutrality](https://en.wikipedia.org/wiki/Net_neutrality) ! Check out [this page](https://db.ffdn.org/) for more information.
</div>
<div class="row">
<div class="block-center text-center">
<a href="/install_on_vps"><img src="/images/vps.png" height=150 style="vertical-align:bottom; text-align:center"><b><p>On a dedicated or virtual private server</p></b></a>
</div>
</div>
@ -52,48 +78,19 @@ This page lists a few installation guides.
---
<h1 style="font-weight: 100">On a virtual machine/container</h1>
<h1 style="font-weight: 100">Advanced / others</h1>
<div class="row">
<div class="col col-md-3 text-center">
<a href="/install_on_virtualbox"><img src="/images/virtualbox.png" height=150 style="vertical-align:bottom"><b><p>On VirtualBox</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/docker"><img src="/images/docker.png" height=150 style="vertical-align:bottom"><b><p>On Docker</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/vagrant"><img src="/images/vagrant.png" height=150 style="vertical-align:bottom"><b><p>On Vagrant</p></b></a>
</div>
</div>
<br>
---
<h1 style="font-weight: 100">On a remote server</h1>
<div class="row">
<div class="col col-md-3 text-center">
<a href="/install_on_digitalocean"><img src="/images/digitalocean.png" height=150 style="vertical-align:bottom"><b><p>On a DigitalOcean droplet</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_dedicated_server"><img src="/images/vps.png" height=150 style="vertical-align:bottom"><b><p>On a dedicated or a virtual private server</p></b></a>
<a href="/install_on_debian"><img height=150 src="/images/debian-logo.png" style="vertical-align:bottom">
<b><p>On Debian 8/Jessie</p></b></a>
</div>
</div>
<br>
---
<h1 style="font-weight: 100">On Debian</h1>
If you have already installed **Debian 8** (Jessie) on a server, you'll be able to **[install YunoHost with a simple script](/install_on_debian)**.
<a href="/install_on_debian"><img width=100 src="/images/debian-logo.png"></a>

View file

@ -1,6 +1,6 @@
# Guide dinstallation
Il existe plusieurs manières dinstaller YunoHost. La méthode dinstallation diffère légèrement si vous souhaitez linstaller chez vous ou à distance, et du matériel utilisé : **[voir le matériel compatible](/hardware_fr)**
Il existe plusieurs manières dinstaller YunoHost. La méthode dinstallation diffère légèrement si vous souhaitez linstaller chez vous ou à distance, et du matériel utilisé : **[voir le matériel compatible](/hardware_fr)**
Cette page liste plusieurs types dinstallations, classés par catégories.
@ -10,14 +10,17 @@ Cette page liste plusieurs types dinstallations, classés par catégories.
<div class="row">
<div class="col col-md-3 text-center">
<a href="/try_at_home_fr"><img src="/images/usb_key.png" height=150 style="vertical-align:bottom"><b><p>Live CD/USB</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/try_fr"><img height=150 src="/images/logo.png" style="vertical-align:bottom"><b><p>Serveur de démo</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/try_at_home_fr"><img src="/images/usb_key.png" height=150 style="vertical-align:bottom"><b><p>Essayer avec une Live USB</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_virtualbox_fr"><img src="/images/virtualbox.png" height=150 style="vertical-align:bottom"><b><p>Essayer dans une machine virtuelle</p></b></a>
</div>
</div>
@ -30,19 +33,19 @@ Cette page liste plusieurs types dinstallations, classés par catégories.
<div class="row">
<div class="col col-md-3 text-center">
<a href="/installation_brique_fr"><img src="/images/thisisinternet.png" height=150 style="vertical-align:bottom"><b><p>Sur la Brique Internet</p></b></a>
<a href="/install_on_olinuxino_fr"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom"><b><p>Sur une carte OlinuXino (Brique Internet)</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_arm_board_fr"><img src="/images/cubieboard2.png" height=150 style="vertical-align:bottom"><b><p>Sur carte ARM</p></b></a>
<a href="/install_on_raspberry_fr"><img src="/images/raspberrypi.jpg" height=150 style="vertical-align:bottom"><b><p>Sur un Raspberry Pi</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_raspberry_fr"><img src="/images/Raspberry_Pi_2_Model_B_v1.1_front_angle_new.jpg" height=150 style="vertical-align:bottom"><b><p>Sur Raspberry Pi</p></b></a>
<a href="/install_on_arm_board_fr"><img src="/images/cubieboard2.png" height=150 style="vertical-align:bottom"><b><p>Sur une carte ARM</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_iso_fr"><img src="/images/laptop.png" height=150 style="vertical-align:bottom"><b><p>Sur un ordinateur standard</p></b></a>
<a href="/install_iso_fr"><img src="/images/computer.png" height=150 style="vertical-align:bottom"><b><p>Sur un ordinateur standard</p></b></a>
</div>
</div>
@ -51,48 +54,35 @@ Cette page liste plusieurs types dinstallations, classés par catégories.
---
<h1 style="font-weight: 100">Virtuellement</h1>
<h1 style="font-weight: 100">Installer à distance</h1>
<div class="alert alert-info" markdown="1">
<span class="glyphicon glyphicon-heart"></span> Des FAI associatifs près de chez vous sont peut-être capable de vous fournir un *Serveur Privé Virtuel* (VPS), géré par des humains qui respectent les utilisateurs et la [Neutralité du Net](https://fr.wikipedia.org/wiki/Neutralit%C3%A9_du_r%C3%A9seau) ! Voir [cette page](https://db.ffdn.org/) pour plus d'informations.
</div>
<div class="row">
<div class="block-center text-center">
<a href="/install_on_vps_fr"><img src="/images/vps.png" height=150 style="vertical-align:bottom; text-align:center"><b><p>Sur un serveur dédié ou virtuel (VPS)</p></b></a>
</div>
</div>
<br>
---
<h1 style="font-weight: 100">Advanced / others</h1>
<div class="row">
<div class="col col-md-3 text-center">
<a href="/install_on_virtualbox_fr"><img src="/images/virtualbox.png" height=150 style="vertical-align:bottom"><b><p>Sur VirtualBox</p></b></a>
<a href="/vagrant_fr"><img src="/images/vagrant.png" height=150 style="vertical-align:bottom"><b><p>Avec Vagrant</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/docker_fr"><img src="/images/docker.png" height=150 style="vertical-align:bottom"><b><p>Sur Docker</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/vagrant_fr"><img src="/images/vagrant.png" height=150 style="vertical-align:bottom"><b><p>Sur Vagrant</p></b></a>
<a href="/install_on_debian_fr"><img height=150 src="/images/debian-logo.png" style="vertical-align:bottom">
<b><p>Sur Debian 8/Jessie</p></b></a>
</div>
</div>
<br>
---
<h1 style="font-weight: 100">À distance</h1>
<div class="row">
<div class="col col-md-3 text-center">
<a href="/install_on_digitalocean_fr"><img src="/images/digitalocean.png" height=150 style="vertical-align:bottom"><b><p>Sur un conteneur DigitalOcean</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_dedicated_server_fr"><img src="/images/vps.png" height=150 style="vertical-align:bottom"><b><p>Sur un serveur dédié</p></b></a>
</div>
</div>
<br>
---
<h1 style="font-weight: 100">Sur Debian</h1>
Si vous disposez déjà dun serveur ou dun ordinateur sous **Debian 8** (Jessie), suivez l**[installation par script](/install_on_debian_fr)**.
<a href="/install_on_debian_fr"><img width=100 src="/images/debian-logo.png"></a>

View file

@ -1,27 +0,0 @@
# Install on a DigitalOcean droplet
*Find other ways to install YunoHost **[here](/install)**.*
### Pre-requisite
<img src="/images/digitalocean.png" width=250>
* A [DigitalOcean](https://www.digitalocean.com/) account
* A **Debian 7.x or 8.x 64bits** droplet with at least **512MB** RAM
<div class="alert alert-warning">
<b>Note :</b> The `root` user **must** have a password properly set. Run `sudo passwd root` to ensure this.
</div>
---
## Installation steps
<a class="btn btn-lg btn-default" href="/install_manually">1. Install manually</a>
<a class="btn btn-lg btn-default" href="/postinstall">2. Post-install</a>
---
***If you need help during one of these steps, do not hesitate to use [our support tools](/support).***

View file

@ -1,26 +0,0 @@
# Installation sur un conteneur DigitalOcean
*Trouvez dautres moyens dinstaller YunoHost **[ici](/install_fr)**.*
## Prérequis
<img src="/images/digitalocean.png" width=250>
* Un compte [DigitalOcean](https://www.digitalocean.com/)
* Un conteneur **Debian 7.x ou 8.x 64 bits** avec au moins **512MB** de RAM
<div class="alert alert-warning">
<b>Attention :</b> lutilisateur `root` doit posséder un mot de passe. Exécutez `sudo passwd root` pour être sûr quil est configuré correctement.
</div>
---
## Étapes dinstallation
<a class="btn btn-lg btn-default" href="/install_manually_fr">1. Installer manuellement</a>
<a class="btn btn-lg btn-default" href="/postinstall_fr">2. Post-installation</a>
---
***Si vous avez besoin daide lors de ces étapes, nhésitez pas à utiliser les différents [moyens de support](/support_fr).***

View file

@ -1,21 +1,22 @@
# Install YunoHost on a Raspberry Pi
*Find other ways to install YunoHost **[here](/install)**.*
*Find all the ways to install YunoHost **[here](/install)**.*
<center>
<img src="/images/raspberrypi.jpg" width=350>
</center>
<div class="alert alert-info" markdown="1">
Before setting up a server at home, it is recommended that you know the [limitations imposed by your ISP](/isp). If they are too restrictive you can consider using a VPN to get around those limitations.
</div>
## Pre-requisite
<img src="/images/Raspberry_Pi_2_Model_B_v1.1_front_angle_new.jpg" width=350>
<img src="/images/micro-sd-card.jpg">
- A Raspberry Pi model 1, 2 or 3
- An SD card: **4GB** capacity (or more) and **class10** speed rate is highly recommended
- An other computer to read this guide and access to your Raspberry Pi
- A screen and a keyboard are recommended to control your Raspberry Pi if a problem occurs.
- A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth
- **YunoHost Raspberry Pi images**, available here:
build.yunohost.org
There are two ways of installing, depending on if you can start your server from scratch or not.
- An SD 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 and [following these instructions](https://davidmaitland.me/2015/12/raspberry-pi-zero-headless-setup/))
- The **YunoHost Raspberry Pi image**, available on [build.yunohost.org](http://build.yunohost.org/). (Not needed if you want to manually install YunoHost on an existing Debian system.)
- **(Optional)** A screen and a keyboard, if you can't use an ssh connection to proceed to the post-installation. (Not needed when installing with an image.)
---
@ -25,13 +26,23 @@ There are two ways of installing, depending on if you can start your server from
<a class="btn btn-lg btn-default" href="/plug_and_boot">2. Plug & boot</a>
<a class="btn btn-lg btn-default" href="/postinstall">3. Post-install</a>
<a class="btn btn-lg btn-default" href="/ssh">3. Connect to your server with SSH</a>
<a class="btn btn-lg btn-default" href="/postinstall">4. Proceed to post-installation</a>
---
## Manual installation
Follow these steps if you can't start from scratch and simply use an image. Note - Yunohost installation is different if you have a Raspberry Pi Zero, be careful!
1. Install git
0. Install Raspbian on the SD card and connect to your Pi.
1. The root user must have a password, or the installation will fail. To change the root password:
```bash
sudo passwd root
```
2. Install git
```bash
sudo apt-get install git
```
@ -41,52 +52,11 @@ sudo apt-get install git
git clone https://github.com/YunoHost/install_script /tmp/install_script
```
3. The root user must have a password set, if it isn't the case, set it (whithout the install script failed):
```bash
sudo passwd root
```
4. Update the Pi:
```bash
apt-get update ; apt-get dist-upgrade -y ; apt-get install rpi-update ; rpi-update ; reboot`
```
This will upgrade the Pi, then reboot.
<div class="alert alert-info">
<b>Raspberry Pi Zero users:</b> follow these specific steps for a successfull installation.
</div>
0.1 Install metronome manually:
```bash
apt-get install -y ssl-cert lua-event lua-expat lua-socket lua-sec lua-filesystem
wget https://github.com/YunoHost/metronome/archive/debian/3.7.9+33b7572-1.zip
unzip 3.7.9+33b7572-1.zip
cd metronome-debian-3.7.9-33b7572-1
dpkg-buildpackage -rfakeroot -uc -b -d
cd ..
dpkg -i metronome_3.7.9+33b7572-1_armhf.deb
apt-mark hold metronome
```
4. Execute the installation script
```bash
cd /tmp/install_script && sudo ./install_yunohost
```
---
### Recommended after post-installation
* Connect via SSH: **root@IP.OF.RPI** (password: **yunohost**)
* Change root password: `passwd root`
* Upgrade system: `apt-get update && apt-get dist-upgrade && rpi-update`
* Configure the language, keyboard layout and timezone with the **raspi-config** tool
---
#### Build image
* [Create a Raspberry Pi image](/build_arm_image_en)
***If you need help during one of these steps, do not hesitate to use [our support tools](/support).***

View file

@ -2,21 +2,22 @@
*Toutes les autres façons dinstaller YunoHost sont listées **[ici](/install_fr)**.*
<center>
<img src="/images/raspberrypi.jpg" width=350>
</center>
<div class="alert alert-info" markdown="1">
Avant d'héberger un serveur chez vous, il est recommandé de prendre connaissance des [limitations liées à votre FAI](/isp). Si votre FAI est trop contraignant, il est possible d'utiliser un VPN pour contourner ces limitations.
</div>
## Prérequis
<img src="/images/Raspberry_Pi_2_Model_B_v1.1_front_angle_new.jpg" width=350>
<img src="/images/micro-sd-card.jpg">
- Un Raspberry Pi 1, 2 ou 3
- Une carte SD de capacité minimale de **4 Go** et une certification de vitesse **class10** sont recommandées
- Un autre ordinateur pour parcourir ce guide et accéder à votre Raspberry Pi
- Un écran et un clavier sont recommandés pour pouvoir contrôler votre Raspberry Pi si un problème apparaît
- Un [fournisseur daccès correct](/isp_fr), de préférence avec une bonne vitesse dupload
- Les **images YunoHost pour Raspberry Pi**, disponible ici :
- [Officielle, Wheezy/YunoHost 2.2 créée le 4 juin 2015](http://build.yunohost.org/yunohost4rpi2.img.7z)
- [Non officielle Jessie/YunoHost 2.2 créée le 5 décembre 2015](https://forum.yunohost.org/t/building-a-new-image-for-raspberry-debian-jessie-fr-en/1101/2)
- Un tutoriel d'installation basée sur YunoHost 2.4 a été écrit par AviGNU : http://avignu.wiki.tuxfamily.org/doku.php?id=documentation:yunohost-jessie
Il y a deux façon d'installer Yunohost, soit vous pouvez repartir de zéro avec une nouvelle image ou installer manuellement :
- Un Raspberry Pi 0, 1, 2 ou 3 ;
- Une carte SD : au moins **8 Go** et **Classe 10** (par exemple une [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ;
- Un adaptateur secteur pour la alimenter la carte ;
- Un câble ethernet/RJ-45 pour brancher la carte à votre routeur/box internet. Avec le Raspberry Pi Zero vous pouvez connecter votre carte avec un câble OTG et un adaptateur Wifi USB.
- L'image YunoHost pour Raspberry Pi, à télécharger sur [build.yunohost.org](http://build.yunohost.org/). (Pas nécessaire si vous souhaitez faire une installation manuelle sur un système Debian déjà installé)
- **(Optionnel)** Un écran et un clavier s'il n'est pas possible de se connecter directement en SSH au Raspberry. (Pas nécessaire si vous installez depuis l'image)
---
@ -26,70 +27,39 @@ Il y a deux façon d'installer Yunohost, soit vous pouvez repartir de zéro avec
<a class="btn btn-lg btn-default" href="/plug_and_boot_fr">2. Brancher & démarrer</a>
<a class="btn btn-lg btn-default" href="/postinstall_fr">3. Post-installation</a>
<a class="btn btn-lg btn-default" href="/ssh_fr">3. Se connecter en SSH</a>
<a class="btn btn-lg btn-default" href="/postinstall_fr">4. Procéder à la post-installation</a>
---
## Installation manuelle
Utilisez cette méthode si vous ne pouvez pas repartir de zéro et utiliser une image. Attention, ces étapes sont différentes si vous installez sur un Raspberry Pi Zero !
1. Installer git
```bash
sudo apt-get install git
```
0. Installez Raspbian sur la carte SD puis connectez-vous en ssh au Raspberry Pi.
<!-- [TODO : Cette partie n'est pas triviale et dois être détaillée comme pour OLinuXino !!] -->
2. Cloner le repo Yunohost install script
```bash
git clone https://github.com/YunoHost/install_script /tmp/install_script
```
3. L'user root doit avoir un mot de passe. Si ce n'est pas le cas l'installation ne marchera pas:
1. L'user root doit avoir un mot de passe. (Si ce n'est pas le cas l'installation ne marchera pas.)
```bash
sudo passwd root
```
4. Mettre à jour le Pi:
2. Installer git
```bash
apt-get update ; apt-get dist-upgrade -y ; apt-get install rpi-update ; rpi-update ; reboot`
sudo apt-get install git
```
Cela va mettre à jour le Pi, puis rebooter.
<div class="alert alert-info">
<b>Raspberry Pi Zero :</b> suivez ces étapes pour une installation réussie.
</div>
0.1 Installez metronome manuellement:
3. Récupérer le script d'installation de Yunohost
```bash
apt-get install -y ssl-cert lua-event lua-expat lua-socket lua-sec lua-filesystem
wget https://github.com/YunoHost/metronome/archive/debian/3.7.9+33b7572-1.zip
unzip 3.7.9+33b7572-1.zip
cd metronome-debian-3.7.9-33b7572-1
dpkg-buildpackage -rfakeroot -uc -b -d
cd ..
dpkg -i metronome_3.7.9+33b7572-1_armhf.deb
apt-mark hold metronome
git clone https://github.com/YunoHost/install_script /tmp/install_script
```
4. Executer le script d' installation
4. Executez le script d' installation
```bash
cd /tmp/install_script && sudo ./install_yunohost
```
---
### Recommandé après la post-installation
* Se connecter en [ssh](ssh_fr) : **root@IP.DU.RPI** (mot de passe : **yunohost**)
* Changer le mot de passe root : ```passwd root```
* Mettre à jour le système dexploitation : ```apt-get update && apt-get dist-upgrade && rpi-update```
* Configurer la langue, le clavier et le fuseau horaire avec l'outil **raspi-config**
---
#### Créer une image
* [Créer une image pour Raspberry](/build_arm_image_fr)
---
***Si vous avez besoin daide lors de ces étapes, nhésitez pas à utiliser les différents [moyens de support](/support_fr).***
***Si vous avez besoin daide lors de ces étapes, nhésitez pas à utiliser les différents [outils de support](/support_fr).***

View file

@ -6,8 +6,9 @@
<img src="/images/vps.png" width=250>
* A dedicated server **OR** a VPS with at least **256MB** RAM
* A **Debian 8** or **7** OS up and running on it
* A dedicated or virtual private server
* with at least **512MB** RAM
* and **Debian 8.x (Jessie) 64bits** as operating system
---

View file

@ -6,8 +6,9 @@
<img src="/images/vps.png" width=250>
* Un serveur dédié **OU** un VPS avec au moins **256 MB** de RAM
* Une installation **Debian 8** ou **7** fonctionnelle
* Un serveur dédié ou virtuel
* avec au moins **512MB** RAM
* et **Debian 8.x (Jessie) 64bits** come système d'exploitation
---

View file

@ -14,18 +14,16 @@
* [Self-hosting](/selfhosting_en)
* [Hardware compatible](/hardware)
* [Installation guide](/install)
* [On the Internet Cube](/install_brick_en)
* [On an OLinuXino board](/install_on_olinuxino)
* [On an ARM board](/install_on_arm_board)
- [On an Olimex board](/install_on_olinuxino)
* [On a Raspberry Pi](/install_on_raspberry)
* [From an ISO](/install_iso)
* [On Debian](/install_on_debian)
* [On VirtualBox](/install_on_virtualbox)
* [On Docker](/docker)
* [On Vagrant](/vagrant)
* [On a DigitalOcean droplet](/install_on_digitalocean)
* [On a dedicated or a virtual private server](/install_on_dedicated_server)
* Instalation steps
* [On a dedicated or a virtual private server](/install_on_vps)
* Installation steps
* [Burn or copy iso](/burn_or_copy_iso)
* [Boot and graphical install](/boot_and_graphical_install)
* [Copy YunoHost image on SD card](/copy_image)

View file

@ -14,17 +14,15 @@
* [Lauto-hébergement](/selfhosting_fr)
* [Matériel compatible](/hardware_fr)
* [Guide dinstallation](/install_fr)
* [Sur la Brique Internet](/installation_brique_fr)
* [Sur une carte OLinuXino](/install_on_olinuxino_fr)
* [Sur carte ARM](/install_on_arm_board_fr)
- [Sur carte Olimex](/install_on_olinuxino_fr)
* [Sur Raspberry Pi](/install_on_raspberry_fr)
* [À partir de lISO](/install_iso_fr)
* [Sur Debian](/install_on_debian_fr)
* [Sur VirtualBox](/install_on_virtualbox_fr)
* [Sur Docker](/docker_fr)
* [Sur Vagrant](/vagrant_fr)
* [Sur un conteneur DigitalOcean](/install_on_digitalocean_fr)
* [Sur un serveur dédié](/install_on_dedicated_server_fr)
* [Sur un serveur dédié](/install_on_vps_fr)
* Étapes dinstallation
* [Graver ou copier lISO](/burn_or_copy_iso_fr)
* [Démarrage et installation graphique](/boot_and_graphical_install_fr)

65
ssh.md
View file

@ -1,26 +1,65 @@
#SSH
**SSH** permit you to command remotly your sever by command line interface (CLI).
# SSH
##### To connect to your server:
## What's SSH ?
`ssh admin@my-server.org`
**SSH** stands for Secure Shell, and refers to a protocol that allows to remotly control a machine using the command line interface (CLI). It is available by default on Linux and Mac OS / OSX. On Windows, unfortunately you might need to use the [PuTTy](http://www.fastcomet.com/tutorials/getting-started/putty) software.
## During Yunohost installation
#### Find your IP
If you are installing on a VPS, then your VPS provider should have gave you your IP address.
If you are installing at home (e.g. on a Raspberry Pi or OLinuXino), then you need to find out which IP has been attributed to your board after you plugged it to your internet box / router. Several ways exists to find your server's IP :
- open a terminal and use `sudo arp-scan --local` to list the IP on your local network ;
- use your internet box / router interface to list the machines connected, or check the logs ;
- plug a screen on your server, log in and type `ifconfig`.
#### Connect
Assuming your IP address is `111.222.333.444`, open a terminal and enter :
```bash
ssh root@111.222.333.444
```
A password will be asked. If this is a VPS, your VPS provided should have communicated you the password. On a fresh Raspberry Pi, the password might be `raspberry`. For an OLinuXino, this should be `olinux`.
#### Change the password !
After logging in for the first time, you should change the root password. The server might automatically ask you to do so. If not, use the command `passwd`. It is important to choose a reasonably strong password.
## After installing Yunohost
If you installed your server at home and are attempting to connect from outside your local network, make sure port 22 is correctly forwarded to your server.
If you only know the IP of your server :
```bash
ssh admin@111.222.333.444
```
Then, you need to enter your administrator password created at [post-installation step](postinstall).
##### Connect to a different port than the default port 22
Edit the line`Port 22` from file `/etc/ssh/sshd_config` then connect:
If you configured your DNS (or tweaked your `/etc/hosts`), you can simply use your domain name :
```bash
ssh -p <port> admin@my-server.org
ssh admin@your.domain.tld
```
##### Which users?
Only the admin user can log in to YunoHost ssh server.
If you changed the SSH port, you need to add `-p <portnumber>` to the command, e.g. :
YunoHost's users created via the administration interface are managed by the LDAP directory and can not connect via ssh.
```bash
ssh -p 2244 admin@your.domain.tld
```
If you want another admin user to log in via ssh, you must create it from the command line (through the admin user) as any user (with `adduser` command).
## Which users?
Note: this user will not be usable since yunohost. It will have its own folder `/home`, his own Unix group (see the principles of a Unix user and the various tutorials on the subject in any good documentation on the administration in Debian).
By default, only the admin and root users can log in to YunoHost ssh server.
YunoHost's users created via the administration interface are managed by the LDAP directory. By default, they can't connect via SSH for security reasons. See [here](https://forum.yunohost.org/t/ssh-disconnects-after-successful-login/256/10) if you absolutely want some users to have SSH access enabled.
## Security and SSH
##### Security and SSH
See the dedicated page [Security & SSH](security_en)

View file

@ -1,26 +1,65 @@
# SSH
Le **SSH** permet de commander à distance son serveur en ligne de commande (CLI).
#### Pour se connecter à son serveur
```bash
ssh admin@mon-serveur.org
```
Ensuite, il est demandé le mot de passe administrateur, celui créé à [létape de post-installation](postinstall_fr).
## Qu'est-ce que SSH ?
**SSH** est un accronyme pour Secure Shell, et désigne un protocole qui permet de contrôler à distance une machine via la ligne de commande (CLI). C'est aussi une commande disponible de base sur Linux et Mac OS / OSX. Sous Windows, maleureusement il vous faudra utiliser le logiciel [PuTTy](http://www.fastcomet.com/tutorials/getting-started/putty).
## Pendant l'installation de YunoHost
#### Trouver son IP
Si vous installez YunoHost sur un VPS, votre fournisseur devrait vous avoir communiqué l'adresse IP de votre serveur.
Si vous installez un serveur à la maison (par ex. sur Raspberry Pi ou OLinuXino), il vous faut trouver l'IP qui a été attribuée à votre carte après que vous l'ayez connecté à votre box internet / routeur. Il y a plusieurs façon de faire ça :
- ouvrez un terminal et tapez `sudo arp-scan --local` pour lister les IP des machines sur le réseau local ;
- utilisez l'interface de votre box internet pour lister les machines connectées, ou regarder les logs ;
- branchez un écran sur votre serveur, loggez-vous et tapez `ifconfig`.
#### Se connecter
En supposant que votre adresse IP est `111.222.333.444`, ouvrez un terminal et tapez :
#### Se connecter à un port différent du port par défaut 22
Éditer la ligne `Port 22` du fichier `/etc/ssh/sshd_config`, puis connectez-vous :
```bash
ssh -p <port> admin@mon-serveur.org
ssh root@111.222.333.444
```
#### Quels utilisateurs?
Seul lutilisateur `admin` peut se connecter en ssh aux serveurs YunoHost.
Un mot de passe sera demandé. Si c'est un VPS, votre fournisseur devrait également vous avoir communiqué un mot de passe. Sur un Raspberry Pi, le password devrait être `raspberry`. Sur un OLinuXino, cela devrait être `olinux`.
Les utilisateurs YunoHost, qui sont gérés par lannuaire LDAP, ne peuvent pas se connecter en ssh.
#### Changer le mot de passe root !
Si vous souhaitez avoir dautres utilisateurs que ladmin pour vous connectez en ssh, il faut le créer depuis la ligne de commande (via lutilisateur admin) comme nimporte quel utilisateur (avec la commande `adduser`).
Après vous être loggé pour la première fois, il vous faut changer le mot de passe root. Le serveur vous demandera peut-être automatiquement de le faire. Si ce n'est pas le cas, il faut utiliser la commande `passwd`. Il est important de choisir un mot de passe raisonnablement compliqué.
Remarque : cet utilisateur ne sera pas utilisable depuis YunoHost. Il aura son propre répertoire `/home`, son propre groupe (cf. les principes dun utilisateur Unix classique et les différents tutoriaux sur le sujet dans toute bonne documentation sur ladministration sous Debian).
## Sur une instance déjà installée
##### Sécurité et SSH
Voir la page dédiée [Sécurité et SSH](security_fr)
Si vous avez installé votre serveur à la maison et que vous cherchez à vous connecter depuis l'extérieur du réseau local, assurez-vous d'avoir bien redirigé le port 22 vers votre serveur.
Si vous connaissez seulement l'IP de votre serveur :
```bash
ssh admin@111.222.333.444
```
Ensuite, entrez le mot de passe administrateur défini pendant la [post-installation](postinstall).
Si vous avez configuré vos DNS (or tweaked your `/etc/hosts`), you can simply use your domain name :
```bash
ssh admin@votre.domaine.tld
```
Si vous avez changé le port SSH, il faut rajouter `-p <numerodeport>` à la commande, par ex. :
```bash
ssh -p 2244 admin@votre.domaine.tld
```
## Quels utilisateurs ?
Par défaut, seulement les utilisateurs admin et root peuvent se logger en SSH sur une instance Yunohost.
Les utilisateurs YunoHost créé via l'interface d'administration sont géré par la base de donnée LDAP. Par défaut, ils ne peuvent pas se connecter en SSH pour des raisons de sécurité. Si vous avez absolument besoin qu'un utilisateur dispose d'un accès SSH, vous pouvez utiliser [cette manipulation](https://forum.yunohost.org/t/ssh-disconnects-after-successful-login/256/10).
## SSH et sécurité
Voir la page dédiée à la [sécurité](security_fr)

View file

@ -5,7 +5,7 @@ You can consider this as some kind of administrator guide for troubleshooting or
## General notes
### Do not break YunoHost
Best way to troubleshoot is to not have to troubleshoot because you have tested everything before deploying it on your server.
That means everytime you want to try a new thing (non-official app, new specific config, package an app…) try it on a development or testing server not on your production one. For this, use whatever way you think appropriate, you can use YunoHost on a [DigitalOcean droplet](install_on_digitalocean_en) for 1 cent/hour, locally with [Docker](/docker_en) or a VM for example.
This means that everytime you want to try a new thing (non-official app, new specific config, package an app...), you should try it on a development or testing instance, *not* on your production server. For this, you can [set up a Vagrant box](vagrant), or for instance a [DigitalOcean droplet](install_on_vps) for 1 cent/hour.
Also: https://wiki.debian.org/DontBreakDebian

View file

@ -5,8 +5,7 @@ Ce guide peut trouver son intérêt lors du débuggage dune nouvelle applicat
## Notes générales
### Ne cassez pas YunoHost
La meilleure manière de ne pas avoir de pannes est de ne pas bricoler sur votre serveur. Cela signifie que dès que vous souhaitez essayer quelque chose de nouveau (application non officielle, nouvelle configuration personnalisée, création dune nouvelle application), voyez plutôt cela sur un serveur de développement et non de production.
Vous pouvez faire cela de la manière qui vous convient, sur un [Droplet DigitalOcean](install_on_digitalocean_en) pour 1 centime/heure, localement avec [Docker](/docker_en) ou sur une machine virtuelle.
La meilleure manière de ne pas avoir de pannes est de ne pas bricoler sur votre serveur. Cela signifie que dès que vous souhaitez essayer quelque chose de nouveau (application non officielle, nouvelle configuration personnalisée, création dune nouvelle application), essayez d'abord cela sur un serveur de test et non de production. Pour faire cela, vous pouvez par exemple utiliser une [box Vagrant](vagrant_fr) ou un [droplet DigitalOcean](install_on_vps_fr) pour 1 centime/here.
Vous pouvez aussi lire ceci si vous avez encore envie de bricoler sur votre instance YunoHost en production : https://wiki.debian.org/DontBreakDebian
@ -16,7 +15,7 @@ Avant de tester, vous devriez lire au moins le code source de lapplication et
Garder à lesprit que quand vous installez une application, vous exécutez du code avec des droits root. De mon expérience, certaines applications sont excellentes, dautres peuvent casser votre instance YunoHost et certaines ne sont plus maintenues. Alors, avant dinstaller, regardez les problèmes rencontrés (issues dans GitHub), le [Forum](http://forum.yunohost.org/)
et [le salon de discussion Yunohost](support_fr) pour voir si dautres ont eu des problèmes avec lapplication.
### vérifier la documentation officielle
### Vérifier la documentation officielle
Les réponses à vos questions existent peut être déjà dans [la documentation](sitemap_fr).
### Vérifier laide dans les commandes en ligne