mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Merge pull request #439 from YunoHost/update-install-doc
Update install documentation
This commit is contained in:
Alexandre Aubin
GitHub
commit
f64b8cbb17
19 changed files with 286 additions and 328 deletions
20
admindoc.md
20
admindoc.md
|
|
@ -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 Debian](/install_on_debian)
|
||||
* [On VirtualBox](/install_on_virtualbox)
|
||||
* [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)
|
||||
|
|
|
|||
|
|
@ -3,23 +3,22 @@
|
|||
* [L’auto-hébergement](/selfhosting_fr)
|
||||
* [Matériel compatible](/hardware_fr)
|
||||
* [Guide d’installation](/install_fr)
|
||||
* [Sur carte ARM](/install_on_arm_board_fr)
|
||||
* [Sur Raspberry Pi](/install_on_raspberry_fr)
|
||||
* [À partir de l’ISO](/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)
|
||||
* Étapes d’installation
|
||||
* [Graver ou copier l’ISO](/burn_or_copy_iso_fr)
|
||||
* [Démarrage et installation graphique](/boot_and_graphical_install_fr)
|
||||
* [Copier l’image YunoHost sur une carte SD](/copy_image_fr)
|
||||
* [Installation manuelle](/install_manually_fr)
|
||||
* [Brancher et démarrer votre serveur](/plug_and_boot_fr)
|
||||
* [Post-installation](/postinstall_fr)
|
||||
* [Diagnostic du bon fonctionnement du YunoHost](/diagnostic_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 l’ISO](/install_iso_fr)
|
||||
* [Sur Debian](/install_on_debian_fr)
|
||||
* [Sur VirtualBox](/install_on_virtualbox_fr)
|
||||
* [Sur Vagrant](/vagrant_fr)
|
||||
* [Sur un serveur dédié](/install_on_vps_fr)
|
||||
* Étapes d’installation
|
||||
* [Graver ou copier l’ISO](/burn_or_copy_iso_fr)
|
||||
* [Démarrage et installation graphique](/boot_and_graphical_install_fr)
|
||||
* [Copier l’image YunoHost sur une carte SD](/copy_image_fr)
|
||||
* [Installation manuelle](/install_manually_fr)
|
||||
* [Brancher et démarrer votre serveur](/plug_and_boot_fr)
|
||||
* [Post-installation](/postinstall_fr)
|
||||
* [Diagnostic du bon fonctionnement du YunoHost](/diagnostic_fr)
|
||||
* [DNS - Système de nom de domaine](/dns_fr)
|
||||
* [Bureaux d’enregistrements de nom de domaine - Registrar](registrar_fr)
|
||||
* [Configuration du DNS chez son registrar](/dns_config_fr)
|
||||
|
|
|
|||
BIN
images/computer.png
Normal file
BIN
images/computer.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 154 KiB |
BIN
images/olinuxino.jpg
Normal file
BIN
images/olinuxino.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 91 KiB |
BIN
images/raspberrypi.jpg
Normal file
BIN
images/raspberrypi.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 61 KiB |
87
install.md
87
install.md
|
|
@ -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>
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# Guide d’installation
|
||||
|
||||
Il existe plusieurs manières d’installer YunoHost. La méthode d’installation diffère légèrement si vous souhaitez l’installer chez vous ou à distance, et du matériel utilisé : **[voir le matériel compatible](/hardware_fr)**
|
||||
Il existe plusieurs manières d’installer YunoHost. La méthode d’installation diffère légèrement si vous souhaitez l’installer chez vous ou à distance, et du matériel utilisé : **[voir le matériel compatible](/hardware_fr)**
|
||||
|
||||
Cette page liste plusieurs types d’installations, classés par catégories.
|
||||
|
||||
|
|
@ -10,14 +10,17 @@ Cette page liste plusieurs types d’installations, 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 d’installations, 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 d’installations, 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à d’un serveur ou d’un 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>
|
||||
|
|
|
|||
|
|
@ -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).***
|
||||
|
|
@ -1,26 +0,0 @@
|
|||
# Installation sur un conteneur DigitalOcean
|
||||
|
||||
*Trouvez d’autres moyens d’installer 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> l’utilisateur `root` doit posséder un mot de passe. Exécutez `sudo passwd root` pour être sûr qu’il est configuré correctement.
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## Étapes d’installation
|
||||
|
||||
<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 d’aide lors de ces étapes, n’hésitez pas à utiliser les différents [moyens de support](/support_fr).***
|
||||
|
|
@ -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).***
|
||||
|
||||
|
|
|
|||
|
|
@ -2,21 +2,22 @@
|
|||
|
||||
*Toutes les autres façons d’installer 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 d’accès correct](/isp_fr), de préférence avec une bonne vitesse d’upload
|
||||
- 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 d’exploitation : ```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 d’aide lors de ces étapes, n’hésitez pas à utiliser les différents [moyens de support](/support_fr).***
|
||||
***Si vous avez besoin d’aide lors de ces étapes, n’hésitez pas à utiliser les différents [outils de support](/support_fr).***
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -19,4 +20,4 @@
|
|||
|
||||
---
|
||||
|
||||
***If you need help during one of these steps, do not hesitate to use [our support tools](/support).***
|
||||
***If you need help during one of these steps, do not hesitate to use [our support tools](/support).***
|
||||
|
|
@ -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
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -14,17 +14,15 @@
|
|||
* [L’auto-hébergement](/selfhosting_fr)
|
||||
* [Matériel compatible](/hardware_fr)
|
||||
* [Guide d’installation](/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 l’ISO](/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 d’installation
|
||||
* [Graver ou copier l’ISO](/burn_or_copy_iso_fr)
|
||||
* [Démarrage et installation graphique](/boot_and_graphical_install_fr)
|
||||
|
|
|
|||
67
ssh.md
67
ssh.md
|
|
@ -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.
|
||||
|
||||
##### Security and SSH
|
||||
See the dedicated page [Security & SSH](security_en)
|
||||
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
|
||||
|
||||
See the dedicated page [Security & SSH](security_en)
|
||||
|
|
|
|||
71
ssh_fr.md
71
ssh_fr.md
|
|
@ -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 l’utilisateur `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 l’annuaire LDAP, ne peuvent pas se connecter en ssh.
|
||||
#### Changer le mot de passe root !
|
||||
|
||||
Si vous souhaitez avoir d’autres utilisateurs que l’admin pour vous connectez en ssh, il faut le créer depuis la ligne de commande (via l’utilisateur admin) comme n’importe 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 d’un utilisateur Unix classique et les différents tutoriaux sur le sujet dans toute bonne documentation sur l’administration 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)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
@ -342,4 +342,4 @@ Webapp can take multiple form an can be deployed in many way. Go app have usuall
|
|||
Never install Apache or a package withe Apache as dependency, this will probably break your YunoHost intance.
|
||||
|
||||
##### Note on https
|
||||
Sometimes the webserver integrated with the app is capable to serve https on its own, it's right to use this when you have one application on one server and you don't want to install Nginx for intance. But in YunoHost case, Nginx who serve https and it simplify configuration. So when passing the local URL to Nginx via proxy_pass, use http, nginx will https the thing to the open world later.
|
||||
Sometimes the webserver integrated with the app is capable to serve https on its own, it's right to use this when you have one application on one server and you don't want to install Nginx for intance. But in YunoHost case, Nginx who serve https and it simplify configuration. So when passing the local URL to Nginx via proxy_pass, use http, nginx will https the thing to the open world later.
|
||||
|
|
|
|||
|
|
@ -5,8 +5,7 @@ Ce guide peut trouver son intérêt lors du débuggage d’une 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 d’une 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 d’une 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 l’application et
|
|||
Garder à l’esprit que quand vous installez une application, vous exécutez du code avec des droits root. De mon expérience, certaines applications sont excellentes, d’autres peuvent casser votre instance YunoHost et certaines ne sont plus maintenues. Alors, avant d’installer, 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 d’autres ont eu des problèmes avec l’application.
|
||||
|
||||
### 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 l’aide dans les commandes en ligne
|
||||
|
|
@ -367,4 +366,4 @@ Ne jamais installer le serveur web Apache ou un paquet avec Apache comme dépend
|
|||
|
||||
##### Note sur https
|
||||
Parfois, le serveur web intégré avec l’application est capable de servir du https lui-même.
|
||||
C’est une bonne chose de l’utiliser quand vous disposez d’une application sans Nginx devant. Dans le cadre de YunoHost, le fait que Nginx serve du https simplifie la configuration. Donc, quand vous passez par proxy_pass, utilisez http et Nginx mettra a disposition en https pour le reste de l’internet.
|
||||
C’est une bonne chose de l’utiliser quand vous disposez d’une application sans Nginx devant. Dans le cadre de YunoHost, le fait que Nginx serve du https simplifie la configuration. Donc, quand vous passez par proxy_pass, utilisez http et Nginx mettra a disposition en https pour le reste de l’internet.
|
||||
|
|
|
|||
Loading…
Reference in a new issue