Merge branch 'grav' of https://github.com/YunoHost/doc

.gitignore

@@ -1,2 +1,4 @@
-*~
+/*
-*.sw[op]
+!/pages
+!/images
+!/themes

admindoc.md

@@ -1,64 +0,0 @@
-# Administrator documentation
-
-* Discovering self-hosting
-    * [What is Self-hosting](/selfhosting)
-    * [What is YunoHost](/whatsyunohost)
-    * [Try YunoHost](/try)
-    * [How to host yourself](howtohostyourself)
-        * [Choosing hardware](/hardware)
-        * [About the friendliness of internet service providers](/isp)
-* [Installing YunoHost](/install)
-    * [On a regular computer](/install_iso)
-    * [On a dedicated or a virtual private server](/install_on_vps)
-    * [On a Raspberry Pi](/install_on_raspberry)
-    * [On an ARM board](/install_on_arm_board)
-    * [On Debian](/install_on_debian)
-    * [On VirtualBox](/install_on_virtualbox)
-* Finalizing your setup
-    * [Post-installation](/postinstall)
-    * [Configuring port forwarding](/isp_box_config)
-    * [Configuring DNS records](/dns_config)
-    * [Installing an SSL certificate](/certificate)
-    * [Diagnose if your setup is working properly](/diagnostic)
-* Getting to know YunoHost
-    * [Overview of YunoHost](/overview)
-    * [General advices and guidelines](/guidelines)
-    * [Web administration interface](/admin)
-    * [SSH](/ssh) and [command-line administration](/commandline)
-    * [Users and the SSO](/users)
-    * [Groups and permissions](/groups_and_permissions)
-    * [Applications](/apps_overview)
-    * [Domains, DNS and certificates](/domains)
-    * [Email](/email)
-       * [Forms to remove its IP address from the black lists](/blacklist_forms)
-    * [XMPP](/XMPP)
-    * [Backup](/backup)
-    * [Updating the system](/update) and [apps](/app_update)
-    * [Security](/security)
-* Going further
-    * Domain names
-        * [Noho.st / nohost.me / ynh.fr domain names](/dns_nohost_me)
-        * [Configure a dynamic DNS with a dynamic IP address](/dns_dynamicip)
-        * [DNS and subdomains for apps](/dns_subdomains)
-        * [Managing DNS records at OVH](/OVH)
-    * Notes about some French ISPs
-        * [SFR](/isp_sfr)
-        * [Orange](/isp_orange)
-        * [Free](/isp_free) 
-    * [Specific apps documentations](/appsdoc)
-    * [Equivalence between Framasoft service and apps](/apps_framasoft)
-    * [Exchange files with your server using a graphical interface](/filezilla)
-    * [Customize the appearance of the YunoHost portal](/theming)
-    * [Adding an external storage](/external_storage)
-    * [Moving an app folder to an other storage](/moving_app_folder)
-    * [Migrating emails to YunoHost](/email_migration)
-    * [Hide services with Tor](/torhiddenservice)
-    * [Using certificates other than Let's Encrypt](/certificate_custom)
-    * [A discussion about the advantages of using a VPN](/vpn_advantage)
-    * [Stretch->Buster migration procedure](stretch_buster_migration)
-    * [(old) Jessie->Stretch migration procedure](jessie_stretch_migration)
-* Troubleshooting
-    * [Changing the administration password](/change_admin_password)
-    * [Recover access to your server](/noaccess)
-    * [Unban IPs in IPiptables/Fail2Ban](/fail2ban)
-    * [Configuring IPv6](/ipv6)

admindoc_fr.md

@@ -1,64 +0,0 @@
-# Documentation pour les administrateurs YunoHost
-
-* Découvrir l'auto-hébergement
-    * [Qu'est-ce que l'auto-hébergement](/selfhosting)
-    * [Qu'est-ce que YunoHost](/whatsyunohost)
-    * [Essayer YunoHost](/try)
-    * [Choisir son mode d'hébergement](/howtohostyourself)
-        * [Matériel compatible](/hardware)
-        * [À propos des fournisseurs d'accès internet](/isp)
-* [Guide d’installation](/install)
-    * [Sur un ordinateur "standard"](/install_iso)
-    * [Sur un serveur dédié ou virtuel (VPS)](/install_on_vps)
-    * [Sur un Raspberry Pi](/install_on_raspberry)
-    * [Sur une carte ARM](/install_on_arm_board)
-    * [Sur Debian](/install_on_debian)
-    * [Sur VirtualBox](/install_on_virtualbox)
-* Finaliser son installation
-    * [Post-installation](/postinstall)
-    * [Configurer les redirections de port](/isp_box_config)
-    * [Configurer les enregistrements DNS](/dns_config)
-    * [Installer un certificat SSL](/certificate)
-    * [Diagnostic du bon fonctionnement du YunoHost](/diagnostic)
-* Apprendre à connaitre YunoHost
-    * [Vue d'ensemble de YunoHost](/overview)
-    * [Conseil généraux](/guidelines)
-    * [L'interface d'administration web](/admin)
-    * [SSH](/ssh) et [l'administration en ligne de commande](/commandline)
-    * [Les utilisateurs et le SSO](/users)
-    * [Les groupes et les permissions](/groups_and_permissions)
-    * [Les applications](/apps_overview)
-    * [Les domaines, la configuration DNS et les certificats](/domains)
-    * [Les emails](/email)
-       * [Formulaires pour enlever son adresse IP des listes noires](/blacklist_forms)
-    * [XMPP](/XMPP)
-    * [Les sauvegardes](/backup)
-    * [Mettre à jour le système](/update) et [les applications](/app_update)
-    * [La sécurité](/security)
-* Pour aller plus loin
-    * Noms de domaine
-        * [Nom de domaine en noho.st / nohost.me / ynh.fr](/dns_nohost_me)
-        * [Configurer un DNS dynamique avec une adresse IP dynamique](/dns_dynamicip)
-        * [DNS et installation d’une application sur un sous-domaine](/dns_subdomains)
-        * [Gérer les enregistrements DNS chez OVH](/OVH)
-    * Notes à propos de certains fournisseurs d'accès à Internet
-        * [SFR](/isp_sfr)
-        * [Orange](/isp_orange)
-        * [Free](/isp_free)
-    * [Documentation spécifique à certaines apps](/appsdoc)
-    * [Équivalence entre service Framasoft et apps](/apps_framasoft)
-    * [Échanger des fichiers avec son serveur à l'aide d'une interface graphique](/filezilla)
-    * [Modifier l'apparence du portail utilisateur](/theming)
-    * [Ajouter un stockage externe](/external_storage)
-    * [Déplacer un dossier d'app vers un autre stockage](/moving_app_folder)
-    * [Migrer ses emails vers YunoHost](/email_migration)
-    * [YunoHost avec un service caché Tor](/torhiddenservice)
-    * [Utilisation de certificats autres que Let's Encrypt](/certificate_custom)
-    * [Une discussion sur les avantages d'utiliser un VPN](/vpn_advantage)
-    * [Procedure de Migration Stretch->Buster](stretch_buster_migration)
-    * [(vieux) Procedure de Migration Jessie->Stretch](jessie_stretch_migration)
-* Dépannage
-    * [Changer le mot de passe d’administration](/change_admin_password)
-    * [Récupérer l'accès à son serveur](/noaccess)
-    * [Débannir une IP dans Fail2Ban/IPtables](/fail2ban)
-    * [Configurer l'IPv6](/ipv6)

app_jappix.md

@@ -1,3 +0,0 @@
-# <img src="/images/jappix_logo.png" height="80px" alt="Jappix logo"> Jappix
-
-Jappix is a web client for [XMPP](/XMPP).

app_jappix_fr.md

@@ -1,3 +0,0 @@
-# <img src="/images/jappix_logo.png" height="80px" alt="Jappix logo"> Jappix
-
-Jappix est un client web [XMPP](/XMPP).

app_nextcloud_calendar.md

@@ -1 +0,0 @@
-default.md

app_nextcloud_carnet.md

@@ -1 +0,0 @@
-default.md

app_nextcloud_contact.md

@@ -1 +0,0 @@
-default.md

app_pleroma.md

@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](app_pleroma_fr) for now.

app_shaarli.md

@@ -1 +0,0 @@
-(This page only exists in french for now)

app_yunofav.md

@@ -1,5 +0,0 @@
-# Yunofav: (unofficial) Page of favorite links for YunoHost
-
-homepage: https://github.com/YunoHost-Apps/yunofav_ynh
-
-Functionality: Creates a page for your favorite links, using the YunoHost tiles look and feel.

app_yunofav_fr.md

@@ -1,6 +0,0 @@
-# Yunofav : (non officiel) Page de liens favoris pour YunoHost
-
-page d'accueil : https://github.com/YunoHost-Apps/yunofav_ynh
-
-
-Fonctionnalité : Crée une page pour vos liens préférés, en utilisant le style et le fonctionnement des tuiles YunoHost.

apps_framasoft.md

@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](apps_framasoft_fr) for now.

boot_and_graphical_install.md

@@ -1,52 +0,0 @@
-# Graphical installation
-
-Now that your YunoHost install medium, you can start with the installation.
-
-## <small>1.</small> Plug the network cable
-
-If you want the network configuration to be set up automatically, you have to plug your server with an **Ethernet** cable **right behind your main router**.
- 
-The wireless connections are not supported yet, and if you use intermediate routers, the network ports opening will not be automatic: Your server will not be accessible externally.
-
-
-## <small>2.</small> Boot on CD / USB stick
-
-Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device** by pressing one of the following keys (hardware specific):    
-```<ESC>```, ```<F9>```, ```<F10>```, ```<F11>```, ```<F12>``` or ```<DEL>```
-
-## <small>3.</small> Launch graphical installation
-
-You should see a screen like this:
-
-<img src="/images/virtualbox_3.png">
-
-
-* Select `Graphical install`
-
-* Select your language, your location and your keyboard layout
-
-* If a partitioning screen appears, confirm.
-
-    <div class="alert alert-danger"><b>Caution:</b> This will totally erase the data on your hard drive</div>
-
-
-* Let the installer do the rest, it will download required packages and install them. 
-
-   <div class="alert alert-info">If it fails, you probably have an Internet connection issue.    
-Check that your computer is physically connected and retry.</div>
-
-* It should reboot automatically.
-
-## <small>4.</small> Log in
-
-After the reboot, you should see a black screen with a few words asking you to
-log in. You can log with the following credentials :
-
-* User: **root**
-* Password: **yunohost**
-
-## <small>5.</small> Proceed to post-installation
-
-<a class="btn btn-lg btn-default" href="/postinstall">Post-install documentation</a>
-
-

config/site.yaml

@@ -0,0 +1,7 @@
+title: YunoHost documentation
+author:
+  name: YunoHost contributors
+  email: 'yunohost@yunohost.org'
+metadata:
+    description: 'The multi-language documentation for the selfhosting system YunoHost'
+

config/system.yaml

@@ -0,0 +1,212 @@
+absolute_urls: false
+timezone: null
+param_sep: ':'
+wrapped_site: false
+reverse_proxy_setup: false
+force_ssl: false
+force_lowercase_urls: true
+custom_base_url: null
+username_regex: '^[a-z0-9_-]{3,16}$'
+pwd_regex: '(?=.*\d)(?=.*[a-z])(?=.*[A-Z]).{8,}'
+intl_enabled: true
+http_x_forwarded:
+  protocol: true
+  host: false
+  port: true
+  ip: true
+languages:
+  supported:
+    - en
+    - fr
+    - de
+    - es
+    - ar
+  default_lang: null
+  include_default_lang: true
+  include_default_lang_file_extension: true
+  translations: true
+  translations_fallback: true
+  session_store_active: true
+  http_accept_language: false
+  override_locale: false
+  content_fallback: {  }
+  pages_fallback_only: false
+home:
+  alias: /home
+  hide_in_urls: false
+pages:
+  type: regular
+  theme: yunohost-docs
+  order:
+    by: default
+    dir: asc
+  list:
+    count: 20
+  dateformat:
+    default: null
+    short: 'jS M Y'
+    long: 'F jS \a\t g:ia'
+  publish_dates: true
+  process:
+    markdown: true
+    twig: false
+  twig_first: false
+  never_cache_twig: false
+  events:
+    page: true
+    twig: true
+  markdown:
+    extra: false
+    auto_line_breaks: false
+    auto_url_links: false
+    escape_markup: false
+    special_chars:
+      '>': gt
+      '<': lt
+    valid_link_attributes:
+      - rel
+      - target
+      - id
+      - class
+      - classes
+  types:
+    - html
+    - htm
+    - xml
+    - txt
+    - json
+    - rss
+    - atom
+  append_url_extension: null
+  expires: 604800
+  cache_control: null
+  last_modified: false
+  etag: false
+  vary_accept_encoding: false
+  redirect_default_route: false
+  redirect_default_code: '302'
+  redirect_trailing_slash: true
+  ignore_files:
+    - .DS_Store
+  ignore_folders:
+    - .git
+    - .idea
+  ignore_hidden: true
+  hide_empty_folders: false
+  url_taxonomy_filters: true
+  frontmatter:
+    process_twig: false
+    ignore_fields:
+      - form
+      - forms
+cache:
+  enabled: true
+  check:
+    method: file
+  driver: auto
+  prefix: g
+  purge_at: '0 4 * * *'
+  clear_at: '0 3 * * *'
+  clear_job_type: standard
+  clear_images_by_default: true
+  cli_compatibility: false
+  lifetime: 604800
+  gzip: false
+  allow_webserver_gzip: false
+  redis:
+    socket: null
+    server: null
+    port: null
+    password: null
+  memcache:
+    server: null
+    port: null
+  memcached:
+    server: null
+    port: null
+twig:
+  cache: true
+  debug: true
+  auto_reload: true
+  autoescape: false
+  undefined_functions: true
+  undefined_filters: true
+  umask_fix: false
+assets:
+  css_pipeline: false
+  css_pipeline_include_externals: true
+  css_pipeline_before_excludes: true
+  css_minify: true
+  css_minify_windows: false
+  css_rewrite: true
+  js_pipeline: false
+  js_pipeline_include_externals: true
+  js_pipeline_before_excludes: true
+  js_minify: true
+  enable_asset_timestamp: false
+  collections:
+    jquery: 'system://assets/jquery/jquery-2.x.min.js'
+errors:
+  display: 1
+  log: true
+log:
+  handler: file
+  syslog:
+    facility: local6
+debugger:
+  enabled: false
+  provider: clockwork
+  censored: false
+  shutdown:
+    close_connection: true
+  twig: true
+images:
+  default_image_quality: 85
+  cache_all: false
+  cache_perms: '0755'
+  debug: false
+  auto_fix_orientation: true
+  seofriendly: false
+  defaults:
+    loading: auto
+media:
+  enable_media_timestamp: false
+  unsupported_inline_types: null
+  allowed_fallback_types: null
+  auto_metadata_exif: false
+  upload_limit: 2097152
+session:
+  enabled: true
+  initialize: true
+  timeout: 1800
+  name: grav-site
+  uniqueness: path
+  secure: false
+  httponly: true
+  samesite: Lax
+  split: true
+  path: null
+gpm:
+  releases: testing
+  proxy_url: null
+  method: auto
+  verify_peer: true
+  official_gpm_only: true
+accounts:
+  type: regular
+  storage: file
+flex:
+  cache:
+    index:
+      enabled: true
+      lifetime: 60
+    object:
+      enabled: true
+      lifetime: 600
+    render:
+      enabled: true
+      lifetime: 600
+strict_mode:
+  yaml_compat: true
+  twig_compat: true
+  blueprint_compat: true

config/themes/yunohost-docs.yaml

@@ -0,0 +1,12 @@
+enabled: true
+production-mode: false
+grid-size: grid-xl
+github:
+  note: false
+  link: true
+  tree: https://github.com/tituspijean/doc/blob/grav/
+  commits: https://github.com/tituspijean/doc/commits/grav/
+spectre:
+  exp: false
+  icons: false
+top_level_version: true

docs.md

@@ -1,34 +0,0 @@
-# Documentation
-
-<p class="lead">
-YunoHost's documentation has 2 different sections:
-</p>
-
-<div class="row text-center">
-
-<div class="col col-md-4 col-md-offset-1">
-<a class="btn btn-primary btn-lg" href="/admindoc"><span class="glyphicon glyphicon-lock"></span> Administrator guide</a>
-<p><small class="text-muted">Including installation, server management and application management</small></p>
-</div>
-
-<div class="col col-md-4 col-md-offset-1">
-<a class="btn btn-danger btn-lg" href="/contributordoc"><span class="glyphicon glyphicon-heart"></span> Contributor guide</a>
-<p><small class="text-muted">Which contains everything you have to know about us and the way we work</small></p>
-</div>
-
-</div>
-
-* Project's life:
-   * [Frequently asked questions](/faq)
-   * [Project news](/news)
-   * [Project organization](/project_organization)
-   * [Project budget](/project_budget)
-   * [Forum](https://forum.yunohost.org)
-   * [Chat rooms](/chat_rooms)
-   * [Communication](/communication)
-   * [Support / Help](/help)
-   * [Sponsors and partners](/sponsors_partners)
-
-* Use example:
-   * [YunoHost for non-profit organisations](/use_case_non-profit_organisations)
-   * (FR) [YunoHost for CHATONS (A collective of independant, transparent, open, neutral and ethical hosters providing FLOSS-based online services.)](https://wiki.chatons.org/doku.php/yunohost) 

install.md

@@ -1,90 +0,0 @@
-# Installation guide
-
-There are multiple ways to install YunoHost. The process may differ slightly depending on whether it takes place at home or on a remote server, and depending on the hardware used: **[See the requirements](/hardware)**
-
-This page lists a few installation guides.
-
----
-
-<h1 style="font-weight: 100">Give it a try</h1>
-
-<div class="row">
-
-<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="/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>
-
-<br>
-
----
-
-<h1 style="font-weight: 100">Install at home</h1>
-
-<div class="row">
-
-<div class="col col-md-3 text-center">
-<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_on_arm_board"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom; padding:20px"><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>
-
-<br>
-
----
-
-<h1 style="font-weight: 100">Advanced / others</h1>
-
-<div class="row">
-
-<div class="col col-md-3 text-center">
-<a href="/install_on_debian"><img height=150 src="/images/debian-logo.png" style="vertical-align:bottom">
-<b><p>On Debian 10/Buster</p></b></a>
-</div>
-
-<div class="col col-md-3 text-center">
-<a href="/dev"><img src="/images/lxc.png" height=150 style="vertical-align:bottom"><b><p>Dev environment in LXD/LXC</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>(Non-official!) Docker images</p></b></a>
-</div>
-
-</div>

install_iso.md

@@ -1,36 +0,0 @@
-# Install on a regular computer
-
-*Find other ways to install YunoHost **[here](/install)**.*
-
-### Requirements
-
-<img src="/images/laptop.png" width=200>
-<img src="/images/desktop.jpg">
-<img src="/images/nettop.jpg">
-
-* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop.    
-You can use any computer with **256MB RAM or more**.
-* Another computer to read this guide and access to your server.
-* A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth
-* A **USB stick** of at least 1GB capacity **OR** a standard **blank CD**
-* ***Particular case*** : If your server has no graphic card, [prepare iso for booting with serial port](https://github.com/luffah/debian-mkserialiso).
-
----
-
-## Installation steps
-
-
-<a class="btn btn-lg btn-default" href="/images">0. Download the YunoHost ISO image</a>
-
-<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Burn the ISO image on a USB stick</a>
-
-<a class="btn btn-lg btn-default" href="/boot_and_graphical_install">2. Boot the machine and run the installation</a>
-
-<a class="btn btn-lg btn-default" href="/postinstall">3. Proceed with the initial configuration (post-installation)</a>
-
----
-
-To connect directly to your computer or with [SSH](/ssh) (only on local network:
-* User: **root**
-* Password: **yunohost**
-

install_manually.md

@@ -1,22 +0,0 @@
-# Installing YunoHost manually
-
-<div class="alert alert-info">
-This procedure only works on **Debian 10** machines <small>(with **kernel >= 3.12**)</small>)
-</div>
-
-Once you have access to a command line on your server (either directly or through SSH), you can install yunohost by running command as root :
-
-```bash
-curl https://install.yunohost.org | bash
-```
-
-<small>*(If `curl` is not installed on your system, you might need to install it with `apt install curl`. Otherwise, if the command does not do anything, you might want to `apt install ca-certificates`)*</small>
-
-Once the installation is finished, you may want to [**proceed to post-installation**](/postinstall)
-
----
-
-**Note for advanced users concerned with the `curl|bash` approach**
-
-If you strongly object to the `curl|bash` way (and similar commands) of installing software, consider reading ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) on Sandstom's blog, and possibly [this discussion on Hacker News](https://news.ycombinator.com/item?id=12766350).
-

install_on_vps.md

@@ -1,19 +0,0 @@
-# Install on a dedicated server
-
-*Find other ways to install YunoHost **[here](/install)**.*
-
-### Pre-requisite
-
-<img src="/images/vps.png" width=250>
-
-* A dedicated or virtual private server
-* with at least **512MB** RAM
-* and **Debian 10.x (Buster) 64bits** as operating system
-
----
-
-## 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. Proceed with the initial configuration (post-installation)</a>

isp_free.md

@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](isp_free_fr) for now.

isp_orange.md

@@ -1,86 +0,0 @@
-# Orange
-
-*Find the list of other Internet service providers **[here](/isp)**.*
-
-#### Email
-
-The Orange box has port 25 closed so as to limit the amount of spam that could be sent from a compromised home connection.
-
-The remaining solution to host one own's email at home is to route it through the Orange SMTP servers.
-
-To that end, one has to edit the postfix configuration file with the following command:
-
-```bash
-sudo nano /etc/postfix/main.cf
-```
-
-then, add the SMTP Orange server as a relay on the associated line:
-
-```bash
-relayhost = smtp.orange.fr
-```
-
-restart Postfix :
-
-```bash
-sudo service postfix restart
-```
-
-##### Problems
-
-If you are having an "Authentication required" error, the solution is as follows (note: french website): **[source](http://viruslocker.free.fr/?page_id=1749)**.
-
-Edit the postfix configuration file
-
-```bash
-sudo nano /etc/postfix/main.cf
-```
-then, add the following lines:
-
-```bash
-smtp_sasl_password_maps = hash:/etc/postfix/sasl/mdp_fai.conf
-smtp_sasl_auth_enable = yes
-smtp_sasl_security_options = noanonymous
-relayhost = [smtp.orange.fr]:25
-```
-
-Create the `mdp_fai.conf` file :
-
-```bash
-sudo nano /etc/postfix/sasl/mdp_fai.conf
-```
-
-add
-
-```bash
-# mdp_fai.conf
-[smtp.orange.fr]:25  emailaddress@at.orange:my-own-password
-```
-with your Orange account password.
-
-Integrate the password into Postfix :
-
-```bash
-sudo postmap /etc/postfix/sasl/mdp_fai.conf
-sudo postconf -e smtp_sasl_password_maps=hash:/etc/postfix/sasl/mdp_fai.conf
-```
-
-If you are having an "(SASL authentication failed; cannot authenticate to server smtp-auth.nowhere.com[38.123.22.160]: no mechanism available)" error
-
-Check that `libsasl2-modules` and `sasl2-bin` are present :
-
-```bash
-apt search libsasl2-modules
-apt search sasl2-bin
-```
-
-If they are not present, do install them :
-
-```bash
-apt install libsasl2-modules sasl2-bin
-```
-
-It is possible that postfix does not immediately take into account your modifications. To force it to do so, run
-```bash
-systemctl restart postfix
-```

isp_sfr.md

@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](isp_sfr_fr) for now.

noaccess.md

@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](noaccess_fr) for now.

orga/README.md

@@ -1 +0,0 @@
-yunohost_project_organization_fr.md

orphaned/dns.es.md

@@ -10,7 +10,7 @@ DNS significa « Domain Name Server » en inglés, y está frecuentemente empl
 
 **Por ejemplo** : `yunohost.org` apunta hacia `88.191.153.110`.
 
-Este sistema fue creado para poder memorizar más fácilmente las direcciones de servidores. Existen registros DNS en los cuales hay que apuntarse. Esto se hace con **registrars** que te alquilarán estos nombres de dominio a cambio de cierto importe (entre cinco y algunas centenas de euros). Estos [registrars](registrar) son entidades privadas autorizadas por el [ICANN](https://es.wikipedia.org/wiki/Corporaci%C3%B3n_de_Internet_para_la_Asignaci%C3%B3n_de_Nombres_y_N%C3%BAmeros), tales como [Gandi](http://gandi.net), [OVH](http://ovh.com) o [BookMyName](http://bookmyname.com).
+Este sistema fue creado para poder memorizar más fácilmente las direcciones de servidores. Existen registros DNS en los cuales hay que apuntarse. Esto se hace con **registrars** que te alquilarán estos nombres de dominio a cambio de cierto importe (entre cinco y algunas centenas de euros). Estos [registrars](/registrar) son entidades privadas autorizadas por el [ICANN](https://es.wikipedia.org/wiki/Corporaci%C3%B3n_de_Internet_para_la_Asignaci%C3%B3n_de_Nombres_y_N%C3%BAmeros), tales como [Gandi](http://gandi.net), [OVH](http://ovh.com) o [BookMyName](http://bookmyname.com).
 
 Es importante notar que los subdominios no necesariamente apuntan al dominio principal.
 

orphaned/dns.fr.md

@@ -14,7 +14,7 @@ DNS signifie « Domain Name Server » en anglais, et est souvent employé pour
 
 **Par exemple** : `yunohost.org` renvoie vers `88.191.153.110`.
 
-Ce système a été créé pour pouvoir retenir plus facilement les adresses de serveur. Il existe donc des registres DNS dans lesquels il faut s’inscrire. Ceci peut être fait auprès de **registrars** qui vous feront louer ces noms de domaine contre une certaine somme (entre cinq et quelques centaines d’euros). Ces [registrars](registrar) sont des entités privées autorisées par l’[ICANN](http://fr.wikipedia.org/wiki/ICANN), telles que [Gandi](http://gandi.net), [OVH](http://ovh.com) ou [BookMyName](http://bookmyname.com).
+Ce système a été créé pour pouvoir retenir plus facilement les adresses de serveur. Il existe donc des registres DNS dans lesquels il faut s’inscrire. Ceci peut être fait auprès de **registrars** qui vous feront louer ces noms de domaine contre une certaine somme (entre cinq et quelques centaines d’euros). Ces [registrars](/registrar) sont des entités privées autorisées par l’[ICANN](http://fr.wikipedia.org/wiki/ICANN), telles que [Gandi](http://gandi.net), [OVH](http://ovh.com) ou [BookMyName](http://bookmyname.com).
 
 Il est important de noter que les sous-domaines ne renvoient pas nécessairement au domaine principal.
 Si `yunohost.org` renvoie vers `88.191.153.110`, ça ne signifie pas que `backup.yunohost.org` renvoie vers la même IP. Vous devez donc configurer **tous** les domaines et sous-domaines que vous souhaitez utiliser.

orphaned/dns.md

@@ -10,7 +10,7 @@ DNS stands for "Domain Name Server", and is often used for the configuration of
 
 **For example**: `yunohost.org` points to the server at `88.191.153.110`.
 
-This system was created to more easily keep track of server addresses. There are DNS registries for Internet names that you must register with. They are called "registrars", which will let you rent certain domain names for a price (between $5 or a few hundred, depending on the root domain and the chosen name). These [registrars](registrar) are private entities authorised by [ICANN](http://en.wikipedia.org/wiki/ICANN), such as [OVH](https://www.ovh.co.uk/index.xml), [Gandi](http://gandi.net), [NameCheap](http://namecheap.com) or [BookMyName](http://bookmyname.com). A privacy respecting registrar is [Njalla](https://njal.la/) or [Njalla Onion Site](http://njalladnspotetti.onion). With Njalla, you can register a domain name with just an email or XMPP address (N.B. : you won't have full control and ownership of the domain though).
+This system was created to more easily keep track of server addresses. There are DNS registries for Internet names that you must register with. They are called "registrars", which will let you rent certain domain names for a price (between $5 or a few hundred, depending on the root domain and the chosen name). These [registrars](/registrar) are private entities authorised by [ICANN](http://en.wikipedia.org/wiki/ICANN), such as [OVH](https://www.ovh.co.uk/index.xml), [Gandi](http://gandi.net), [NameCheap](http://namecheap.com) or [BookMyName](http://bookmyname.com). A privacy respecting registrar is [Njalla](https://njal.la/) or [Njalla Onion Site](http://njalladnspotetti.onion). With Njalla, you can register a domain name with just an email or XMPP address (N.B. : you won't have full control and ownership of the domain though).
 
 It is important to note that subdomains do not necessarily have to send you to wherever the principal domain is pointing. If `yunohost.org` sends to `88.191.153.110`, that doesn't mean that `backup.yunohost.org` has to point at the same IP. You must therefore configure **all** of the domains and subdomains that you want to use.
 
@@ -26,7 +26,7 @@ You have several choices here. Note that you can mix and match solutions if you
 
   **This is the recommended option if you are just starting out with self-hosting.**
 
-2. You can use the DNS service offered by your **registrar** (Gandi, NameCheap, BookMyName or others) to configure your domain name. Here is the [standard DNS configuration](/dns_config). The DNS service of your router can also be used, more info on [how to setup a local domain](dns_local_network).
+2. You can use the DNS service offered by your **registrar** (Gandi, NameCheap, BookMyName or others) to configure your domain name. Here is the [standard DNS configuration](/dns_config). The DNS service of your router can also be used, more info on [how to setup a local domain](/dns_local_network).
 You can also check out these pages for specific [registrar](/registrar) documentation: [OVH](https://www.ovh.co.uk/index.xml), [Gandi](http://gandi.net), [NameCheap](http://namecheap.com) or [BookMyName](http://bookmyname.com).
 
   **Warning**: If you choose this option, you will have more configuration possibilities, but nothing will be done for you. For example, if you want to use `webmail.my-server.org`, you must add it manually to the DNS records with your registrar.

orphaned/dns_local_network.es.md

@@ -9,7 +9,7 @@ To solve this issue you can:
 ### Find the local IP address of your server
 
 First you need to find out the local IP of your server
-- either using the tricks lister [here](finding_the_local_ip)
+- either using the tricks lister [here](/finding_the_local_ip)
 - or if in the webadmin, in the Diagnosis section, under Internet Connectivity, IPv4, click on 'Details' and you should find an entry for 'Local IP'
 - or using the command line on the server : `hostname -I`
 

orphaned/dns_local_network.fr.md

@@ -9,7 +9,7 @@ Pour résoudre ce problème:
 ### Trouver l’adresse IP locale du serveur
 
 Tout d'abord il vous faut trouver l'adresse IP locale du serveur
-- soit en utilisant l'une de astuces expliquées [ici](finding_the_local_ip)
+- soit en utilisant l'une de astuces expliquées [ici](/finding_the_local_ip)
 - ou en utilisant la webadmin, dans l'écran Diagnostique, section Connection Internet, IPv4, cliquer sur 'Détails' et vous devriez trouver une entrée pour 'IP locale'.
 - ou en ligne de commande sur le serveur: `hostname -I`
 

orphaned/dns_local_network.md

@@ -9,7 +9,7 @@ To solve this issue you can:
 ### Find the local IP address of your server
 
 First you need to find out the local IP of your server
-- either using the tricks lister [here](finding_the_local_ip)
+- either using the tricks lister [here](/finding_the_local_ip)
 - or if in the webadmin, in the Diagnosis section, under Internet Connectivity, IPv4, click on 'Details' and you should find an entry for 'Local IP'
 - or using the command line on the server : `hostname -I`
 

pages/01.administrate/01.selfhosting/01.whatisyunohost/whatsyunohost.ar.md

@@ -1,4 +1,9 @@
-#<div dir="rtl">ماذا نعني بـ واي يونوهوست YunoHost ؟</div>
+---
+title: ماذا نعني بـ واي يونوهوست YunoHost 
+template: docs
+taxonomy:
+    category: docs
+---
 
 <div dir="rtl">
 واي يونوهوست YunoHost هو **نظام لتشغيل الخوادم** صُمِّم لتسهيل الإستضافة الذاتية لخدمات الإنترنت.

pages/01.administrate/01.selfhosting/01.whatisyunohost/whatsyunohost.de.md

@@ -1,8 +1,13 @@
-# Was ist YunoHost?
+---
+title: Was ist YunoHost?
+template: docs
+taxonomy:
+    category: docs
+---
 
 <img src="/images/YunoHost_logo_vertical.png" width=400>
 
-YunoHost ist ein **Betriebssystem**, das auf die einfachste Verwaltung eines **Servers** abzielt und daher das [Self-Hosting](selfhosting) demokratisiert, wobei sichergestellt wird, dass es zuverlässig, sicher, ethisch einwandfrei und leichtgewichtig bleibt. Es ist ein Copylefted-Libre-Softwareprojekt, das ausschließlich von Freiwilligen betrieben wird. Technisch gesehen kann es als eine Distribution angesehen werden, die auf [Debian GNU/Linux](https://debian.org) basiert und auf [vielen Arten von Hardware](install) installiert werden kann.
+YunoHost ist ein **Betriebssystem**, das auf die einfachste Verwaltung eines **Servers** abzielt und daher das [Self-Hosting](/selfhosting) demokratisiert, wobei sichergestellt wird, dass es zuverlässig, sicher, ethisch einwandfrei und leichtgewichtig bleibt. Es ist ein Copylefted-Libre-Softwareprojekt, das ausschließlich von Freiwilligen betrieben wird. Technisch gesehen kann es als eine Distribution angesehen werden, die auf [Debian GNU/Linux](https://debian.org) basiert und auf [vielen Arten von Hardware](/install) installiert werden kann.
 
 ## Features
 

pages/01.administrate/01.selfhosting/01.whatisyunohost/whatsyunohost.es.md

@@ -1,8 +1,13 @@
-# ¿Qué es YunoHost?
+---
+title: Qué es YunoHost?
+template: docs
+taxonomy:
+    category: docs
+---
 
 <img src="/images/YunoHost_logo_vertical.png" width=400>
 
-YunoHost es un **sistema operativo** que persigue simplificar la administración de un **servidor** para democratizar el [autoalojamiento](selfhosting), asegurando que se mantiene fiable, seguro, ético y ligero. Es un proyecto de software libre copyleft mantenido exclusivamente por voluntarios. Se puede considerar técnicamente como una distribución basada en [Debian GNU/Linux](https://debian.org) y se puede instalar en [muchos tipos de hardware](install).
+YunoHost es un **sistema operativo** que persigue simplificar la administración de un **servidor** para democratizar el [autoalojamiento](/selfhosting), asegurando que se mantiene fiable, seguro, ético y ligero. Es un proyecto de software libre copyleft mantenido exclusivamente por voluntarios. Se puede considerar técnicamente como una distribución basada en [Debian GNU/Linux](https://debian.org) y se puede instalar en [muchos tipos de hardware](/install).
 
 ## Características
 

pages/01.administrate/01.selfhosting/01.whatisyunohost/whatsyunohost.fr.md

@@ -1,6 +1,11 @@
-# Qu’est-ce que YunoHost ?
+---
+title: Qu'est-ce que YunoHost ?
+template: docs
+taxonomy:
+    category: docs
+---
 
-<img src="/images/YunoHost_logo_vertical.png" width=400>
+![YunoHost logo](image://YunoHost_logo_vertical.png?resize=400)
 
 YunoHost est un **système d’exploitation** qui vise à simplifier autant que possible l'administration d'un **serveur** pour ainsi démocratiser [l’auto-hébergement](/selfhosting) tout en restant fiable, sécurisé, éthique et léger. C'est un projet de logiciel libre maintenu exclusivement par des bénévoles. Techniquement, il peut être vu comme une distribution basée sur [Debian GNU/Linux](https://debian.org) et peut s'installer sur [de nombreux types de matériel](/install).
 

pages/01.administrate/01.selfhosting/01.whatisyunohost/whatsyunohost.md

@@ -0,0 +1,55 @@
+---
+title: What is YunoHost?
+template: docs
+taxonomy:
+    category: docs
+---
+
+![YunoHost logo](image://YunoHost_logo_vertical.png?resize=400)
+
+YunoHost is an **operating system** aiming for the simplest administration of a **server**, and therefore democratize [self-hosting](/selfhosting), while making sure it stays reliable, secure, ethical and lightweight. It is a copylefted libre software project maintained exclusively by volunteers. Technically, it can be seen as a distribution based on [Debian GNU/Linux](https://debian.org) and can be installed on [many kinds of hardware](/install).
+
+## Features
+
+- ![](image://icon-debian.png?resize=32&classes=inline) Based on Debian;
+- ![](image://icon-tools.png?resize=32&classes=inline) Administrate your server through a **friendly web interface** ;
+- ![](image://icon-package.png?resize=32&classes=inline) Deploy **apps in just a few clicks**;
+- ![](image://icon-users.png?resize=32&classes=inline) Manage **users** <small>(based on LDAP)</small>;
+- ![](image://icon-globe.png?resize=32&classes=inline) Manage **domain names**;
+- ![](image://icon-medic.png?resize=32&classes=inline) Create and restore **backups**;
+- ![](image://icon-door.png?resize=32&classes=inline) Connect to all apps simultaneously through the **user portal** <small>(NGINX, SSOwat)</small>;
+- ![](image://icon-mail.png?resize=32&classes=inline) Includes a **full e-mail stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
+- ![](image://icon-messaging.png?resize=32&classes=inline)... as well as **an instant messaging server** <small>(XMPP)</small>;
+- ![](image://icon-lock.png?resize=32&classes=inline) Manages **SSL certificates** <small>(based on Let's Encrypt)</small> ;
+- ![](image://icon-shield.png?resize=32&classes=inline)... and **security systems** <small>(Fail2ban, yunohost-firewall)</small>;
+
+## Origin
+
+YunoHost was created in February 2012 after something like this:
+
+<blockquote><p>"Shit, I'm too lazy to reconfigure my mail server... Beudbeud, how were you able to get your little server running with LDAP?"</p>
+<small>Kload, February 2012</small></blockquote>
+
+All that was needed was an admin interface for Beudbeud's server to make something usable, so Kload decided to develop one. Finally, after automating several configs and packaging in some web apps, YunoHost v1 was finished.
+
+Noting the growing enthusiasm around YunoHost and around self-hosting in general, the original developers along with new contributors decided to start work on version 2, a more extensible, more powerful, more easy-to-use, and at that, one that makes a nice cup of fair-trade coffee for the elves of Lapland.
+
+The name **YunoHost** comes from the jargon "Y U NO Host". The [Internet meme](https://en.wikipedia.org/wiki/Internet_meme) should illustrate it:
+![](image://dude_yunohost.jpg)
+
+## What YunoHost is not?
+
+Even if YunoHost can handle multiple domains and multiple users, it is **not meant to be a mutualized system**.
+
+First, the software is too young, not tested at scale and thus probably not optimized well enough for hundreds of users at the same time. With that said, we do not want to lead the software in that direction. Virtualization democratizes, and its usage is recommended since it is a more watertight way to achieve mutualization than a "full-stack" system like YunoHost.
+
+You can host your friends, your family and your company safely and with ease, but you must **trust your users**, and they must trust you above all. If you want to provide YunoHost services for unknown persons anyway, a full VPS per user will be just fine, and we believe a better way to go.
+
+## Artworks
+
+Black and white YunoHost PNG logo by ToZz (400 × 400 px):
+
+[![](image://ynh_logo_black_300dpi.png?resize=220)](image://ynh_logo_black_300dpi.png)
+[![](image://ynh_logo_white_300dpi.png?resize=220)](image://ynh_logo_white_300dpi.png)
+
+Licence: CC-BY-SA 4.0

pages/01.administrate/01.selfhosting/02.tryyunohost/try.ar.md

@@ -1,4 +1,9 @@
-#<div dir="auto">تجريب YunoHost</div>
+---
+title: تجريب YunoHost
+template: docs
+taxonomy:
+    category: docs
+---
 
 <div dir=rtl class="alert alert-warning" markdown="1">
 **ملاحظة :** يمكن لهذا السيرفر التجريبي أن يتوقف من وقت إلى آخر.

pages/01.administrate/01.selfhosting/02.tryyunohost/try.ca.md

@@ -1,4 +1,9 @@
-# Prova YunoHost
+---
+title: Prova YunoHost
+template: docs
+taxonomy:
+    category: docs
+---
 
 <div class="alert alert-warning" markdown="1">
 **Nota:** Aquest és un servidor de demostració, podria estar caigut de tant en tant.

pages/01.administrate/01.selfhosting/02.tryyunohost/try.de.md

@@ -1,4 +1,9 @@
-# YunoHost ausprobieren
+---
+title: YunoHost ausprobieren
+template: docs
+taxonomy:
+    category: docs
+---
 
 <div class="alert alert-warning" markdown="1">
 **Hinweis:** Dieser Demo-Server könnte zeitweilig nicht erreichbar sein.

pages/01.administrate/01.selfhosting/02.tryyunohost/try.es.md

@@ -1,4 +1,9 @@
-# Probar YunoHost
+---
+title: Probar YunoHost
+template: docs
+taxonomy:
+    category: docs
+---
 
 <div class="alert alert-warning" markdown="1">
 **Nota :** Este demo puede dejar de functionar de vez en cuando.

pages/01.administrate/01.selfhosting/02.tryyunohost/try.fr.md

@@ -1,4 +1,9 @@
-# Essayer YunoHost
+---
+title: Essayer YunoHost
+template: docs
+taxonomy:
+    category: docs
+---
 
 <div class="alert alert-warning" markdown="1">
 **Note :** Cette démo peut cesser de fonctionner de temps en temps.

pages/01.administrate/01.selfhosting/02.tryyunohost/try.it.md

@@ -1,4 +1,9 @@
-# Prova YunoHost
+---
+title: Prova YunoHost
+template: docs
+taxonomy:
+    category: docs
+---
 
 <div class="alert alert-warning" markdown="1">
 **Nota:** A volte questo server demo può essere irraggiungibile

pages/01.administrate/01.selfhosting/02.tryyunohost/try.md

@@ -0,0 +1,21 @@
+---
+title: Try YunoHost
+template: docs
+taxonomy:
+    category: docs
+---
+
+! This demo server could be down from time to time.
+
+[center]
+[columns]
+[<i class="fa fa-user"></i> User interface](https://demo.yunohost.org/?target=_blank&classes=btn,btn-lg,btn-success)  
+Username: demo  
+Password: demo
+
+[<i class="fa fa-user"></i> Administration interface](https://demo.yunohost.org/yunohost/admin?target=_blank&classes=btn,btn-lg,btn-primary)  
+Password: demo</p>
+[/columns]
+[/center]
+
+!!! **Demo server gracefully provided by [Gitoyen](https://www.gitoyen.net?target=_blank)**

pages/01.administrate/01.selfhosting/03.howtohostyourself/howtohostyourself.de.md

@@ -1,4 +1,9 @@
-# So hosten Sie selbst ?
+---
+title: So hosten Sie selbst ?
+template: docs
+taxonomy:
+    category: docs
+---
 
 Sie können zu Hause (auf einem kleinen Computer) oder auf einem Remote-Server hosten. Jede Lösung hat ihre Vor- und Nachteile:
 
@@ -7,7 +12,7 @@ Sie können zu Hause (auf einem kleinen Computer) oder auf einem Remote-Server h
 Sie können zu Hause mit einem Einplatinencomputer oder einem überarbeiteten regulären Computer, der mit Ihrem Heimrouter verbunden ist, hosten. 
 
 - **Pros**  : Sie haben die physische Kontrolle über die Maschine und müssen nur die Hardware kaufen;
-- **Cons**  : Sie müssen [Ihre Internet-Router manuell konfigurieren](isp_box_config) und [sind möglicherweise von Ihrem Internet-Service-Provider eingeschränkt](isp).
+- **Cons**  : Sie müssen [Ihre Internet-Router manuell konfigurieren](/isp_box_config) und [sind möglicherweise von Ihrem Internet-Service-Provider eingeschränkt](/isp).
 
 ### Zu Hause hinter einem VPN
 

pages/01.administrate/01.selfhosting/03.howtohostyourself/howtohostyourself.fr.md

@@ -1,4 +1,9 @@
-# Choisir son mode d’autohébergement
+---
+title: Choisir son mode d'autohébergement
+template: docs
+taxonomy:
+    category: docs
+---
 
 Vous pouvez vous auto-héberger à la maison (sur un petit ordinateur), ou sur un serveur distant. Chaque solution a ses avantages et inconvénients :
 
@@ -7,7 +12,7 @@ Vous pouvez vous auto-héberger à la maison (sur un petit ordinateur), ou sur u
 Vous pouvez vous héberger chez vous, sur une carte ARM ou un vieil ordinateur, connecté à votre box internet.
 
 - **Avantages** : vous aurez un contrôle physique sur la machine et avez seulement besoin d'acheter le matériel initial ;
-- **Inconvénients** : il vous faudra [configurer manuellement votre box internet](isp_box_config) et serez possiblement [limité par certains aspects de votre fournisseur d'accès internet](isp).
+- **Inconvénients** : il vous faudra [configurer manuellement votre box internet](/isp_box_config) et serez possiblement [limité par certains aspects de votre fournisseur d'accès internet](/isp).
 
 ### À la maison, derrière un VPN
 

pages/01.administrate/01.selfhosting/03.howtohostyourself/howtohostyourself.md

@@ -1,4 +1,9 @@
-# How to host yourself?
+---
+title: How to host yourself?
+template: docs
+taxonomy:
+    category: docs
+---
 
 You can host yourself at home (on a small computer), or on a remote server. Each solution has their pros and cons:
 
@@ -7,7 +12,7 @@ You can host yourself at home (on a small computer), or on a remote server. Each
 You can host yourself at home with an ARM board or a re-purposed regular computer, connected to your home router/box. 
 
 - **Pros**  : you will have physical control of the machine and only need to buy the hardware;
-- **Cons**  : you will have to [manually configure your internet box](isp_box_config) and [might be limited by your ISP](isp).
+- **Cons**  : you will have to [manually configure your internet box](/administrate/postinstall/ispbox) and [might be limited by your ISP](/administrate/advance/isp).
 
 ### At home, behind a VPN
 

pages/01.administrate/01.selfhosting/selfhosting.de.md

@@ -1,4 +1,9 @@
-# Self-Hosting
+---
+title: Self-Hosting
+template: docs
+taxonomy:
+    category: docs
+---
 
 Self-Hosting ist das Hosten von Daten oder Software auf eigener IT-Infrastruktur.
 Ihren eigenen Server zu Hause zu haben und zu verwalten, um Ihre persönlichen Daten und Dienste selbst zu hosten, anstatt sich ausschließlich auf Dritte zu verlassen. Beispielsweise können Sie Ihren Blog selbst hosten, sodass er auf einem Computer "lebt", über den Sie die Kontrolle haben, anstatt ihn im Austausch gegen Geld, Werbung oder private Daten auf dem Computer eines anderen Benutzers (a.k.a. The Cloud) zu haben.

pages/01.administrate/01.selfhosting/selfhosting.fr.md

@@ -1,4 +1,9 @@
-# L’auto-hébergement
+---
+title: L'auto-hébergement
+template: docs
+taxonomy:
+    category: docs
+---
 
 L'auto-hébergement est le fait d'avoir et d'administrer son propre serveur, typiquement chez soi, pour héberger soi-même ses données personnelles et des services plutôt que de se reposer exclusivement sur des tiers. Par exemple, il est possible d'auto-héberger son blog de sorte qu'il "vive" dans une machine que vous contrôlez, au lieu qu'il soit sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud) en échange d'argent, de publicités ou de données privées.
 

pages/01.administrate/01.selfhosting/selfhosting.md

@@ -1,4 +1,9 @@
-# Self-hosting
+---
+title: Self-hosting
+template: docs
+taxonomy:
+    category: docs
+---
 
 Self-hosting is the activity of having and administrating your own server, typically at home, to host your personal data and services yourself instead of relying exclusively on third-parties. For instance, you can self-host your blog, such that it 'lives' on a machine that you have control of, instead of having it on somebody else's computer (a.k.a. The Cloud) in exchange for money, advertisement or private data.
 

pages/01.administrate/01.selfhosting/selfhosting.ru.md

@@ -1,10 +1,15 @@
-# Самостоятельное развертывание (свой хостинг)
+---
+title: Самостоятельное развертывание (свой хостинг)
+template: docs
+taxonomy:
+    category: docs
+---
 
 #### Значение
 **Свой хостинг** - это сервер, расположенный у вас дома и предназначенный для размещения информации для личных нужд.
 
 #### Обязанности администратора
-Свой хостинг создает для вас определенные обязанности, если вы хотите разместить на нём сайт, [e-mail](/email), а также запустить [систему мгновенных сообщений](XMPP), ваш сервер должен работать и оставаться онлайн 24/7.
+Свой хостинг создает для вас определенные обязанности, если вы хотите разместить на нём сайт, [e-mail](/email), а также запустить [систему мгновенных сообщений](/XMPP), ваш сервер должен работать и оставаться онлайн 24/7.
 
 Распространенные проблемы, по причине которых сервер может быть недоступен включают в себя: отсутствие электроэнергии, потеря доступа к Интернету, итд.
 

pages/01.administrate/02.install/00.hardware/hardware.de.md

@@ -1,4 +1,9 @@
-# Hardware
+---
+title: Hardware
+template: docs
+taxonomy:
+    category: docs
+---
 
 YunoHost kann auf folgender Hardware installiert werden:
 - ARM Boards (Raspberry Pi, Olinuxino LIME1 & 2, Orange Pi, etc.) ;

pages/01.administrate/02.install/00.hardware/hardware.es.md

@@ -1,4 +1,9 @@
-# Hardware
+---
+title: Hardware
+template: docs
+taxonomy:
+    category: docs
+---
 
 YunoHost puede ser instalado en este hardware :
 - Tarjetas ARM (Raspberry Pi, Olinuxino LIME1 & 2, Orange Pi, etc.) ;

pages/01.administrate/02.install/00.hardware/hardware.fr.md

@@ -1,4 +1,9 @@
-# Matériel
+---
+title: Matériel
+template: docs
+taxonomy:
+    category: docs
+---
 
 YunoHost peut être installé sur les types de matériel suivants :
 - Cartes ARM (Raspberry Pi, Olinuxino LIME1 & 2, Orange Pi, etc.) ;

pages/01.administrate/02.install/00.hardware/hardware.md

@@ -1,13 +1,16 @@
-# Hardware
+---
+title: Hardware
+template: docs
+taxonomy:
+    category: docs
+---
 
 YunoHost can be installed on the following hardware:
 - ARM boards (Raspberry Pi, Olinuxino LIME1 & 2, Orange Pi, etc.);
 - 'Old' desktop computers or laptops;
 - Remote servers, a.k.a Virtual Private Servers (VPS).
 
-Corresponding installation guides can be found on [this page](/install).
+## Minimum requirements
-
-### Minimum requirements
 
 * 500 MHz CPU
 * 512 MB RAM (recommended : 1 GB in order to run all the services and apps properly)

pages/01.administrate/02.install/01.iso/00.images/images.ar.md

@@ -1,4 +1,9 @@
-# الصور
+---
+title: الصور
+template: docs
+taxonomy:
+    category: docs
+---
 
 <div id="cards-list">
 </div>

pages/01.administrate/02.install/01.iso/00.images/images.es.md

@@ -1,4 +1,9 @@
-# Imagenes
+---
+title: Imagenes
+template: docs
+taxonomy:
+    category: docs
+---
 
 <span class="javascriptDisclaimer">
 Esta página requiere que Javascript esté instalado par aparecer correctamente :s.

pages/01.administrate/02.install/01.iso/00.images/images.fr.md

@@ -1,4 +1,9 @@
-# Images
+---
+title: Images
+template: docs
+taxonomy:
+    category: docs
+---
 
 <span class="javascriptDisclaimer">
 Cette page requiert que Javascript soit activé pour s'afficher correctement :s.

pages/01.administrate/02.install/01.iso/00.images/images.md

@@ -1,4 +1,9 @@
-# Pre-installed images
+---
+title: Pre-installed images
+template: docs
+taxonomy:
+    category: docs
+---
 
 <span class="javascriptDisclaimer">
 This page requires Javascript enabled to display properly :s.

pages/01.administrate/02.install/01.iso/01.burn_iso/burn_or_copy_iso.fr.md

@@ -1,4 +1,9 @@
-# Flasher l’ISO YunoHost
+---
+title: Flasher l'ISO YunoHost
+template: docs
+taxonomy:
+    category: docs
+---
 
 Maintenant que vous avez téléchargé l’image ISO de YunoHost, vous devez la mettre sur un support physique. Classiquement, il s'agit d'une **Clé USB** ou d'une **Carte SD**.
 

pages/01.administrate/02.install/01.iso/01.burn_iso/burn_or_copy_iso.md

@@ -1,17 +1,26 @@
-# Flashing the YunoHost ISO
+---
+title: Flashing the YunoHost ISO
+template: docs
+taxonomy:
+    category: docs
+---
 
 Now that you downloaded the ISO image of YunoHost, you should flash/burn it on a physical medium. Typically, this is done on a **USB stick** or an **SD card**.
 
-<img src="/images/sdcard.jpg" width=100>
+[center]
-<img src="/images/micro-sd-card.jpg" width=100>
+![SD card](image://sdcard.jpg?resize=100,100&class=inline)
-<img src="/images/usb_key.png" width=150>
+![Micro SD card](image://micro-sd-card.jpg?resize=100,100&class=inline)
-<img src="/images/cd.jpg" width=100>
+![USB drive](image://usb_key.png?resize=100,100&class=inline)
+![CD](image://cd.jpg?resize=100,100&class=inline)
+[/center]
 
 ### (Recommended) With Etcher
 
-Download <a href="https://etcher.io/" target="_blank">Etcher</a> for your operating system and install it.
+Download <a href="https://www.balena.io/etcher/" target="_blank">Etcher</a> for your operating system and install it.
 
-<img src="/images/etcher.gif">
+[center]
+![Etcher](image://etcher.gif?resize=100%&class=inline)
+[/center]
 
 Plug your USB stick, select your YunoHost ISO and click "Flash"
 
@@ -19,7 +28,9 @@ Plug your USB stick, select your YunoHost ISO and click "Flash"
 
 Download <a href="https://unetbootin.github.io/">UNetbootin</a> for your operating system and install it.
 
-<img src="/images/unetbootin.png">
+[center]
+![UNetbootin](image://unetbootin.png?resize=100%&class=inline)
+[/center]
 
 Put your USB stick on, select your YunoHost ISO and click "OK"
 

pages/01.administrate/02.install/01.iso/02.graphical_install/boot_and_graphical_install.fr.md

@@ -1,4 +1,9 @@
-# Installation graphique
+---
+title: Installation graphique
+template: docs
+taxonomy:
+    category: docs
+---
 
 Maintenant que vous possédez un support YunoHost, vous pouvez procéder à l’installation.
 

pages/01.administrate/02.install/01.iso/02.graphical_install/boot_and_graphical_install.md

@@ -0,0 +1,50 @@
+---
+title: Graphical installation
+template: docs
+taxonomy:
+    category: docs
+---
+
+Now that your YunoHost install medium, you can start with the installation.
+
+## 1. Plug the network cable
+
+If you want the network configuration to be set up automatically, you have to plug your server with an **Ethernet** cable **right behind your main router**.
+ 
+The wireless connections are not supported yet, and if you use intermediate routers, the network ports opening will not be automatic: Your server will not be accessible externally.
+
+## 2. Boot on CD / USB stick
+
+Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device** by pressing one of the following keys (hardware specific):    
+```<ESC>```, ```<F9>```, ```<F10>```, ```<F11>```, ```<F12>``` or ```<DEL>```
+
+## 3. Launch graphical installation
+
+You should see a screen like this:
+
+![VirtualBox](image://virtualbox_3.png?class=center)
+
+1. Select `Graphical install`
+2. Select your language, your location and your keyboard layout
+3. If a partitioning screen appears, confirm.
+  !! This will totally erase the data on your hard drive
+4. Let the installer do the rest, it will download required packages and install them.
+
+  ! If it fails, you probably have an Internet connection issue.  
+  ! Check that your computer is physically connected and retry.
+
+5. It should reboot automatically.
+
+## 4. Log in
+
+After the reboot, you should see a black screen with a few words asking you to
+log in. You can log with the following credentials :
+
+* User: `root`
+* Password: `yunohost`
+
+## 5. Proceed to post-installation
+
+<a class="btn btn-lg btn-default" href="/administrate/postinstall">Post-install documentation</a>
+
+

pages/01.administrate/02.install/01.iso/03.images/flex-objects.md

@@ -0,0 +1,8 @@
+---
+title: YunoHost images
+flex:
+  directory: images
+---
+
+# YunoHost images
+

pages/01.administrate/02.install/01.iso/install_iso.es.md

@@ -1,4 +1,9 @@
-# Instalación en un ordenador
+---
+title: Instalación en un ordenador
+template: docs
+taxonomy:
+    category: docs
+---
 
 *Encontrar otros medios de instalar YunoHost **[aquí](/install)**.*
 

pages/01.administrate/02.install/01.iso/install_iso.fr.md

@@ -1,4 +1,9 @@
-# Installation sur ordinateur
+---
+title: Installation sur ordinateur
+template: docs
+taxonomy:
+    category: docs
+---
 
 *Trouvez d’autres moyens d’installer YunoHost **[ici](/install)**.*
 

pages/01.administrate/02.install/01.iso/install_iso.it.md

@@ -1,4 +1,9 @@
-# Installazione in un computer
+---
+title: Installazione in un computer
+template: docs
+taxonomy:
+    category: docs
+---
 
 *Altri modi per installare YunoHost **[Clicca qui](/install)**.*
 

pages/01.administrate/02.install/01.iso/install_iso.md

@@ -0,0 +1,40 @@
+---
+title: Install on a regular computer
+template: docs
+taxonomy:
+    category: docs
+---
+
+## Requirements
+
+[center]
+![Laptop](image://laptop.png?resize=200,200&class=inline)
+![Desktop](image://desktop.jpg?resize=200,200&class=inline)
+![Nettop](image://nettop.jpg?resize=200,200&class=inline)
+[/center]
+
+* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop.    
+You can use any computer with **256MB RAM or more**.
+* Another computer to read this guide and access to your server.
+* A [reasonable ISP](/administrate/advance/isp), preferably with a good and unlimited upstream bandwidth
+* A **USB stick** of at least 1GB capacity **OR** a standard **blank CD**
+* ***Particular case*** : If your server has no graphic card, [prepare iso for booting with serial port](https://github.com/luffah/debian-mkserialiso).
+
+---
+
+## Installation steps
+
+[0. Download the YunoHost ISO image](/administrate/install/iso/images?classes=btn,btn-lg,btn-primary)
+
+[1. Burn the ISO image on a USB stick](/administrate/install/iso/burn_iso?classes=btn,btn-lg,btn-primary)
+
+[2. Boot the machine and run the installation](/administrate/install/iso/graphical_install?classes=btn,btn-lg,btn-primary)
+
+[3. Proceed with the initial configuration (post-installation)](/administrate/postinstall?classes=btn,btn-lg,btn-primary)
+
+---
+
+To connect directly to your computer or with [SSH](/ssh) (only on local network:
+* User: `root`
+* Password: `yunohost`
+

pages/01.administrate/02.install/01.iso/install_iso_de.md

@@ -1,4 +1,9 @@
-# Instalation auf einem normalen Computer
+---
+title: Instalation auf einem normalen Computer
+template: docs
+taxonomy:
+    category: docs
+---
 
 *Um andere Wege zu finden, YunoHost zu instalieren, klicke **[hier](/install)**.*
 

pages/01.administrate/02.install/02.vps/install_on_vps.de.md

@@ -1,4 +1,9 @@
-# Installation auf einem dedizierten Server
+---
+title: Installation auf einem dedizierten Server
+template: docs
+taxonomy:
+    category: docs
+---
 
 *Andere Wege Yunohost zu installieren findest Du  **[hier](/install)**.*
 

pages/01.administrate/02.install/02.vps/install_on_vps.es.md

@@ -1,4 +1,9 @@
-# Instalación en un servidor dedicado
+---
+title: Instalación en un servidor dedicado
+template: docs
+taxonomy:
+    category: docs
+---
 
 *Encontrar otros medios de instalar YunoHost **[aquí](/install)**.*
 

pages/01.administrate/02.install/02.vps/install_on_vps.fr.md

@@ -1,4 +1,9 @@
-# Installation sur un serveur dédié
+---
+title: Installation sur un serveur dédié
+template: docs
+taxonomy:
+    category: docs
+---
 
 *Trouvez d’autres moyens d’installer YunoHost **[ici](/install)**.*
 

pages/01.administrate/02.install/02.vps/install_on_vps.it.md

@@ -1,4 +1,9 @@
-# Installa su un server dedicato
+---
+title: Installa su un server dedicato
+template: docs
+taxonomy:
+    category: docs
+---
 
 *Scopri altri modi di installare YunoHost **[qui](/install)**.*
 

pages/01.administrate/02.install/02.vps/install_on_vps.md

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