From 463ab5e1abce8c430ffd25f81df8768df4404008 Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Thu, 19 Jan 2017 21:01:16 +0100 Subject: [PATCH] Misc update related to update docs --- admindoc.md | 20 ++++++++--- admindoc_fr.md | 33 +++++++++---------- install.md | 2 +- install_fr.md | 2 +- install_on_digitalocean.md | 27 --------------- install_on_digitalocean_fr.md | 26 --------------- ...n_dedicated_server.md => install_on_vps.md | 7 ++-- ...cated_server_fr.md => install_on_vps_fr.md | 5 +-- sitemap.md | 6 ++-- sitemap_fr.md | 4 +-- troubleshooting_guide.md | 4 +-- troubleshooting_guide_fr.md | 7 ++-- 12 files changed, 48 insertions(+), 95 deletions(-) delete mode 100644 install_on_digitalocean.md delete mode 100644 install_on_digitalocean_fr.md rename install_on_dedicated_server.md => install_on_vps.md (71%) rename install_on_dedicated_server_fr.md => install_on_vps_fr.md (80%) diff --git a/admindoc.md b/admindoc.md index cb87d8d1..0ef320b5 100644 --- a/admindoc.md +++ b/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 the Internet Cube](/install_brick_en) + * [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) diff --git a/admindoc_fr.md b/admindoc_fr.md index 5bde3f4d..d53913ff 100644 --- a/admindoc_fr.md +++ b/admindoc_fr.md @@ -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 la Brique Internet](/installation_brique_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) diff --git a/install.md b/install.md index 01421e72..93269dfd 100644 --- a/install.md +++ b/install.md @@ -76,7 +76,7 @@ This page lists a few installation guides.
-

On a dedicated or virtual private server

 +

On a dedicated or virtual private server
diff --git a/install_fr.md b/install_fr.md index f0ee69e9..0432fc3e 100644 --- a/install_fr.md +++ b/install_fr.md @@ -72,7 +72,7 @@ Cette page liste plusieurs types d’installations, classés par catégories.
-

Sur un serveur dédié ou virtuel (VPS)

 +

Sur un serveur dédié ou virtuel (VPS)
diff --git a/install_on_digitalocean.md b/install_on_digitalocean.md deleted file mode 100644 index 324bb8e6..00000000 --- a/install_on_digitalocean.md +++ /dev/null @@ -1,27 +0,0 @@ -# Install on a DigitalOcean droplet - -*Find other ways to install YunoHost **[here](/install)**.* - -### Pre-requisite - - - -* A [DigitalOcean](https://www.digitalocean.com/) account -* A **Debian 7.x or 8.x 64bits** droplet with at least **512MB** RAM - -
- Note : The `root` user **must** have a password properly set. Run `sudo passwd root` to ensure this. -
- - ---- - -## Installation steps - -1. Install manually - -2. Post-install - ---- - -***If you need help during one of these steps, do not hesitate to use [our support tools](/support).*** \ No newline at end of file diff --git a/install_on_digitalocean_fr.md b/install_on_digitalocean_fr.md deleted file mode 100644 index 3ca82b97..00000000 --- a/install_on_digitalocean_fr.md +++ /dev/null @@ -1,26 +0,0 @@ -# Installation sur un conteneur DigitalOcean - -*Trouvez d’autres moyens d’installer YunoHost **[ici](/install_fr)**.* - -## Prérequis - - - -* Un compte [DigitalOcean](https://www.digitalocean.com/) -* Un conteneur **Debian 7.x ou 8.x 64 bits** avec au moins **512MB** de RAM - -
- Attention : l’utilisateur `root` doit posséder un mot de passe. Exécutez `sudo passwd root` pour être sûr qu’il est configuré correctement. -
- ---- - -## Étapes d’installation - -1. Installer manuellement - -2. Post-installation - ---- - -***Si vous avez besoin d’aide lors de ces étapes, n’hésitez pas à utiliser les différents [moyens de support](/support_fr).*** diff --git a/install_on_dedicated_server.md b/install_on_vps.md similarity index 71% rename from install_on_dedicated_server.md rename to install_on_vps.md index f154d04c..d16c436e 100644 --- a/install_on_dedicated_server.md +++ b/install_on_vps.md @@ -6,8 +6,9 @@ -* 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).*** \ No newline at end of file +***If you need help during one of these steps, do not hesitate to use [our support tools](/support).*** diff --git a/install_on_dedicated_server_fr.md b/install_on_vps_fr.md similarity index 80% rename from install_on_dedicated_server_fr.md rename to install_on_vps_fr.md index 899edf6e..05a89169 100644 --- a/install_on_dedicated_server_fr.md +++ b/install_on_vps_fr.md @@ -6,8 +6,9 @@ -* 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 +* and **Debian 8.x (Jessie) 64bits** as operating system --- diff --git a/sitemap.md b/sitemap.md index 5e08e9b3..ca3ae1ee 100644 --- a/sitemap.md +++ b/sitemap.md @@ -20,11 +20,9 @@ * [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) diff --git a/sitemap_fr.md b/sitemap_fr.md index 5d027138..116aeb4b 100644 --- a/sitemap_fr.md +++ b/sitemap_fr.md @@ -20,10 +20,8 @@ * [À 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) diff --git a/troubleshooting_guide.md b/troubleshooting_guide.md index 20d1b409..c6ada8fc 100644 --- a/troubleshooting_guide.md +++ b/troubleshooting_guide.md @@ -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. \ No newline at end of file +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. diff --git a/troubleshooting_guide_fr.md b/troubleshooting_guide_fr.md index 9fb5abb1..5298c265 100644 --- a/troubleshooting_guide_fr.md +++ b/troubleshooting_guide_fr.md @@ -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. \ No newline at end of file +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.