diff --git a/XMPP.md b/XMPP.md index dae040e2..8fda18f7 100644 --- a/XMPP.md +++ b/XMPP.md @@ -1,17 +1,53 @@ -# -XMPP is a communication protocol of instant messaging, VoIP (Voice over IP), videoconferencing. +# Chat, VoIP and social network with -YunoHost provide: -* [Metronome](https://metronome.im/): a XMPP server +YunoHost comes installed with an instant messaging server Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol). -## Desktop XMPP client +XMPP is an open and extensible protocol which allows to create chatrooms, to share status and data, to give calls in VoIP and videoconferences. -You can connect to your XMPP server with any standard desktop XMPP client, such as [Pidgin](http://pidgin.im/), [Gajim](http://gajim.org), [Jitsi](http://jitsi.org/) or [Adium](https://adium.im/). +All applications based on XMPP are compatible with each other : when using an XMPP client, you can interact with anybody who has an XMPP/Jabber account. This protocol is already used by millions of people around the world. -The credentials to give are : -* Your email address (with the @domain.tld) -* Your standard YunoHost password +### XMPP/Jabber account -Your XMPP server runs on the standard port 5222. Your administrator might need to forward this port if the server is behind a router. +An XMPP/Jabber account is based on an identifier with the structure `user@domain.tld`, and a password. - +In YunoHost, this identifier simply corresponds to the main email address of a user, with his regular password. + +### Connecting to XMPP + +There are several web client built with social network features : +- [Movim](https://pod.movim.eu) +- [Libervia/Salut à Toi](http://salut-a-toi.org/). + +You can also use a desktop client such as : +- [Pidgin](http://pidgin.im/) (multiplatform), +- [Gajim](http://gajim.org/) (Linux), +- [Dino](https://dino.im) (Linux), +- [Thunderbird](https://www.thundebird.net/) (multiplatform), +- [Jitsi](http://jitsi.org/) (multiplatform) +- [Adium](https://adium.im/) (Mac OS). + +... or a mobile client +* [Xabber](http://xabber.com) (Android) +* [Conversations](https://conversations.im/) (Android) +* [Movim under Android](https://movim.eu) +* [Monal](https://itunes.apple.com/us/app/monal-free-xmpp-chat/id317711500?mt=8) (iOS) + +Here is an exhaustive list of XMPP clients : https://en.wikipedia.org/wiki/Comparison_of_XMPP_clients + +### Encrypt conversations with OMEMO + +XMPP chats can be encrypted with the help of [OMEMO](https://xmpp.org/extensions/xep-0384.html), for instance using Gajim : +* Install `gajim` and the plugin `gajim-omemo` +* Enable the plugin in `Tools > Plugins` +* Enable it +* Enable the encryption in the chat with somebody who also has OMEMO + +### Chatrooms + +To create a chatroom (multi-user chat) on your YunoHost server, use the identifier `chatroomname@muc.yourdomain.tld`. + +For this to workm you need to [add the corresponding `muc.` DNS record](dns_config_fr) in the DNS configuration. + +### VoIP and visioconferences + +A practical tool to call an XMPP client, either with voice or voice+video, is to use the client [Jitsi](http://jitsi.org/). diff --git a/XMPP_fr.md b/XMPP_fr.md index 2ae2df86..35b02dcf 100644 --- a/XMPP_fr.md +++ b/XMPP_fr.md @@ -1,8 +1,8 @@ #Chat, VoIP et réseau social avec -Yunohost est installé avec un serveur de messagerie instantanée XMPP (metronome). +Yunohost est installé avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol). -[XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) est un protocole ouvert et extensible qui permet également de créer des salons de discussions, de partager des statuts et des données, de passer des appels en VoIP et de faire de la visioconférence. +XMPP est un protocole ouvert et extensible qui permet également de créer des salons de discussions, de partager des statuts et des données, de passer des appels en VoIP et de faire de la visioconférence. Toutes les applications basées sur XMPP sont compatibles entre-elles : lorsque vous utilisez un client XMPP vous pouvez discuter avec n’importe quel possesseur d’un compte XMPP/Jabber. Ce protocole est déjà utilisé par des millions de personnes dans le monde. @@ -14,12 +14,21 @@ Sous yunohost, cet identifiant correspond simplement à l’adresse courriel pri ### Se connecter à XMPP -Il existe des clients web orientés réseau social, comme [Movim](https://pod.movim.eu) ou [Libervia/Salut à Toi](http://salut-a-toi.org/). +Il existe des clients web orientés réseau social, comme : +- [Movim](https://pod.movim.eu) +- [Libervia/Salut à Toi](http://salut-a-toi.org/). -Vous pouvez également utiliser un client desktop comme [Pidgin](http://pidgin.im/) (multiplateforme), [Gajim](http://gajim.org/index.fr.html) (Linux), [thunderbird](https://www.mozilla.org/fr/thunderbird/) (multiplateforme), [Jitsi](http://jitsi.org/) (multiplateforme) ou [Adium](https://adium.im/) (Mac OS). +Vous pouvez également utiliser un client desktop comme +- [Pidgin](http://pidgin.im/) (multiplateforme), +- [Gajim](http://gajim.org/index.fr.html) (Linux), +- [Dino](https://dino.im) (Linux), +- [Thunderbird](https://www.mozilla.org/fr/thunderbird/) (multiplateforme), +- [Jitsi](http://jitsi.org/) (multiplateforme) +- [Adium](https://adium.im/) (Mac OS). ... ou un client smartphone * [Xabber](http://xabber.com) (Android) +* [Conversations](https://conversations.im/) (Android) * [Movim sous Android](https://movim.eu) * [Monal](https://itunes.apple.com/us/app/monal-free-xmpp-chat/id317711500?mt=8) (iOS) @@ -37,7 +46,7 @@ Il est possible de chiffrer ses conversations XMPP à l’aide de [OMEMO](https: Pour créer un salon de discussion (Multi-user chat) sur votre serveur Yunohost utilisez l’identifiant nomsalon@muc.domaine.tld (où domaine.tld est le domaine principal de votre serveur). -Si vous utilisez un nom de domaine personnel, il est nécessaire d’[ajouter une redirection de `type CNAME` pour le sous domaine `muc.`](dns_config_fr) au niveau de votre serveur DNS. +Si vous utilisez un nom de domaine personnel, il est nécessaire d’[ajouter une redirection de type CNAME pour le sous domaine `muc.`](dns_config_fr) au niveau de votre serveur DNS. ### VoIP et visioconférence diff --git a/admindoc.md b/admindoc.md index 497d6804..841cedcf 100644 --- a/admindoc.md +++ b/admindoc.md @@ -3,10 +3,10 @@ * Discovering self-hosting * [What is Self-hosting](/selfhosting) * [What is YunoHost](/whatsyunohost) -* Before installing * [Try YunoHost](/try) - * [Choosing hardware](/hardware) - * [About the friendliness of internet service providers](/isp) + * [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) @@ -21,14 +21,19 @@ * [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) - * [Connecting to your server using SSH](/ssh) - * [Command-line administration](/commandline) - * [Application catalog](/apps) - * [Updating your server](/update) and [apps](/app_update) + * [SSH](/ssh) and [command-line administration](/commandline) + * [Users and the SSO](/users) + * [Applications](/apps_overview) + * [Domains, DNS and certificates](/domains) + * [Email](/email) + * [XMPP](/XMPP) * [Backup](/backup) + * [Updating the system](/update) and [apps](/app_update) + * [Security](/security) * Going further - * [Improving security](/security) * [Adding an external storage](/external_storage) * [Migrating emails to YunoHost](/email_migration) * [Hide services with Tor](/torhiddenservice) diff --git a/admindoc_fr.md b/admindoc_fr.md index ad504326..08bef02a 100644 --- a/admindoc_fr.md +++ b/admindoc_fr.md @@ -3,10 +3,10 @@ * Découvrir l'auto-hébergement * [Qu'est-ce que l'auto-hébergement](/selfhosting_fr) * [Qu'est-ce que YunoHost](/whatsyunohost_fr) -* Avant de se lancer * [Essayer YunoHost](/try_fr) - * [Matériel compatible](/hardware_fr) - * [À propos des fournisseurs d'accès internet](/isp_fr) + * [Choisir son mode d'hébergement](howtohostyourself-fr) + * [Matériel compatible](/hardware_fr) + * [À propos des fournisseurs d'accès internet](/isp_fr) * [Guide d’installation](/install_fr) * [Sur un ordinateur "standard"](/install_iso_fr) * [Sur un serveur dédié ou virtuel (VPS)](/install_on_vps_fr) @@ -21,16 +21,21 @@ * [Installer un certificat SSL](/certificate_fr) * [Diagnostic du bon fonctionnement du YunoHost](/diagnostic_fr) * Apprendre à connaitre YunoHost - * [L'interface d'administration web](/admin_fr) - * [Se connecter à son serveur via SSH](/ssh_fr) - * [Administrer son serveur en ligne de commande](/commandline_fr) - * [Catalogue d'applications](/apps_fr) - * [Mettre à jour son serveur](/update_fr) et [les apps](/app_update_fr) - * [Les sauvegardes](/backup_fr) + * [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 applications](/apps_overview) + * [Les domaines, la configuration DNS et les certificats](/domains) + * [Les emails](/email) + * [XMPP](/XMPP) + * [Les sauvegardes](/backup) + * [Mettre à jour le système](/update) et [les applications](/app_update) + * [La sécurité](/security) * Pour aller plus loin - * [Améliorer la sécurité](/security_fr) * Noms de domaine - * [Nom de domaine en noho.st / nohost.me](/dns_nohost_me_fr) + * [Nom de domaine en noho.st / nohost.me / ynh.fr](/dns_nohost_me_fr) * [Configurer un DNS dynamique avec une adresse IP dynamique](/dns_dynamicip_fr) * [DNS et installation d’une application sur un sous-domaine](/dns_subdomains_fr) * [Utiliser le résolveur DNS local](/dns_resolver_fr) diff --git a/apps_overview.md b/apps_overview.md new file mode 100644 index 00000000..7e825725 --- /dev/null +++ b/apps_overview.md @@ -0,0 +1,45 @@ +Applications +============ + +One of the key feature of YunoHost is the ability to easily install applications which are then immediately usable. Example of applications include a blog system, a "cloud" (to host and sync files), a website, an RSS reader, ... + +Applications must be packaged manually by application packagers/maintainers. Apps can be integrated with YunoHost to support upgrades, backup/restore and LDAP/SSO integration among other things. + +Applications can be installed and managed through the webadmin interface in 'Applications' or through commands of the `yunohost app` category. + +Application lists +----------------- + +From the technical point of view, applications are public code repository (such as [this one](https://github.com/YunoHost-Apps/wordpress_ynh)). Existing applications are indexed using "application lists". Those lists can be managed in Applications > Install > Manage applications lists or with commands such as `yunohost app fetchlist`. + +By default, YunoHost only knows about the official application list. Those are applications which have been carefully packaged, integrated, reviewed and shall be maintained by the YunoHost team. + +Nevertheless, you might want to have access to the larger catalog of the community list. It can easily be added through the 'Manage applications lists' view of the webadmin, or with the command `yunohost app fetchlist -n community -u https://app.yunohost.org/community.json`. Just be aware that apps in this list offer less guarantees than the official apps and the YunoHost team is not responsible for them ! + +The full list of application (official and community) can be browsed at [this page](/apps). + +Integration and quality levels +------------------------------ + +Automated tests are being ran regularly to test the integration and quality of all official apps, as well as community apps who were declared to be 'working'. The result is a level between 0 and 7, whose meaning is detailed on [this page](/packaging_apps_levels_fr). Some tests results may also be available [on this dashboard](https://dash.yunohost.org/appci/branch/stable). + +LDAP / SSO integration +---------------------- + +Applications may support integration with the LDAP / Single Sign On system, such that users who connects to the user portal can be automatically logged in all those apps. Some applications however do not support this as it can be either not implemented in the upstream, or the package didn't work on this part yet. + +Multi-instance applications +--------------------------- + +Some applications support the ability to be installed several times (at different locations) ! To do so, just go another time in Applications > Install, and select again the application to install. + + +User access management +---------------------- + +Access to apps can be restricted to some users only. This can be configured via the webadmin in Applications > (choose an app) > Access, or similarly via the command line `yunohost app addaccess`, `removeaccess` and `clearaccess`. + +Packaging applications +---------------------- + +If you want to learn or contribute to app packaging, please check the [contributor documentation](contributordoc). diff --git a/apps_overview_fr.md b/apps_overview_fr.md new file mode 100644 index 00000000..107a3a63 --- /dev/null +++ b/apps_overview_fr.md @@ -0,0 +1,46 @@ +Applications +============ + +L'une des fonctionnalités principales de YunoHost est la possibilité d'installer facile des applications immédiatement utilisables. Pour donner des exemples d'application, il est possible d'installer un système de blog, un "cloud" (pour héberger et synchroniser des fichiers), un site web, un lecteur RSS, .... + +Les applications doivent être packagées manuellement par les packageurs/mainteneurs d'applications. Les applications peuvent être intégrées avec YunoHost pour gérer les mise à jour, la sauvegarde/restauration et l'intégration LDAP/SSO, entre autres. + +Les applications peuvent être installées et gérées via l'interface webadmin dansila partie 'Applications', ou via les commandes de la catégorie `yunohost app`. + +Listes d'applications +----------------- + +Du point de vue technique, les applications sont des dépôts de code public (comme [celui-ci](https://github.com/YunoHost-Apps/wordpress_ynh)). Les applications existantes sont indexées à l'aide de "listes d'applications". Ces listes peuvent être gérées dans Applications > Installer > Gérer les listes d'applications, ou avec des commandes telles que `yunohost app fetchlist`. + +Par défaut, YunoHost ne connaît que la liste officielle des applications. Il s'agit d'applications qui ont été soigneusement packagées, intégrées, revues et doivent être maintenues par l'équipe YunoHost. + +Néanmoins, vous souhaiterez peut-être avoir accès au catalogue plus fourni de la liste communautaire. Cette liste peut facilement être ajouté via la vue 'Gérer les listes d'applications' de l'administrateur web, ou avec la commande `yunohost app fetchlist -n community -u https://app.yunohost.org/community.json`. Sachez simplement que les applications de cette liste offrent moins de garanties que les applications officielles et que l'équipe YunoHost n'en est pas responsable ! + +La liste des applications existantes (officielles et communautaires) peut être consultée sur [cette page](/apps). + +Niveaux d'intégration et de qualité +------------------------------ + +Des tests automatisés sont exécutés régulièrement pour tester l'intégration et la qualité de toutes les applications officielles, ainsi que les applications communautaires qui ont été déclarées "working". Le résultat est un niveau entre 0 et 7, dont la signification est détaillée sur [cette page](/packaging_apps_levels_levels_fr). Certains résultats de tests peuvent également être disponibles sur [ce tableau de bord](https://dash.yunohost.org/appci/branch/stable). + +Intégration LDAP / SSO +---------------------- + +Les applications peuvent prendre en charge l'intégration avec le système LDAP / Single Sign On, de sorte que les utilisateurs qui se connectent au portail utilisateur peuvent être automatiquement authentifié sur toutes ces applications. Certaines applications ne le supportent pas car cette fonctionnalité n'est, soit pas implémentée en amont du logiciel de l'app, soit le mainteneur n'a pas encore travaillé sur cette partie. + +Applications multi-instances +--------------------------- + +Certaines applications peuvent être installées plusieurs fois (à différents endroits) ! Pour ce faire, il suffit de retourner dans Applications > Installer, et de sélectionner à nouveau l'application à installer. + + +Gestion de l'accès des utilisateurs +---------------------- + +L'accès aux applications peut être limité à certains utilisateurs seulement. Ceci peut être configuré via la webadmin dans Applications > (une application) > Accès, ou de la même manière via les commandes `yunohost addaccess`, `removeaccess` et `clearaccess`. + +Packaging d'applications +------------------------ + +Si vous voulez apprendre ou contribuer à l'empaquetage des applications, veuillez consulter la [documentation des contributeurs](contributordoc). + diff --git a/commandline.md b/commandline.md index 7e677489..47bbb507 100644 --- a/commandline.md +++ b/commandline.md @@ -1,153 +1,30 @@ -# Moulinette +# Administrate YunoHost in command line -**Moulinette** is the command line interface (CLI) of YunoHost administration. It allows to manage entirely YunoHost: +The command line interface (CLI) is, in the computer world, the original (and more technical) way of interacting with a computer compared to graphical interface. Command line interfaces are generally said to be more complete, powerful or efficient than a graphical interface, though it is more difficult to learn. -users, domains, applications, firewall, backup, monitoring. +In the context of YunoHost, or system administration in general, the CLI is commonly used to remotely control machines after connecting through [connecting to it via SSH](/ssh). -The other interface is a [web administration](/admin), which eliminates the need for the command line. +
+Providing a full tutorial about the command line is quite beyond the scope of the YunoHost documentation : for this, consider reading a dedicated tutorial such as [this one](https://ryanstutorials.net/linuxtutorial/) or [this one](http://linuxcommand.org/). But be reassured that you don't need to be a CLI expert to start using it ! +
-To use Moulinette you need to connect to your server via [SSH](/ssh). +The `yunohost` command can be used to administrate your server and perform the various actions similarly to what you do on the webadmin. The command must be launched either from the `root` user or from the `admin` user by preceeding them with `sudo`. (ProTip™ : you can become `root` with the command `sudo su` as `admin`). -##yunohost +YunoHost commands usually have this kind of structure : -The command to manage YunoHost from the command line: ```bash -usage: yunohost [-h] [-v] - -positional arguments: - {domain,monitor,service,firewall,backup,app,hook,dyndns,user,tools} - domain Manage domains - monitor Monitor the server - service Manage services - firewall Manage firewall rules - backup Manage backups - app Manage apps - hook Manage hooks - dyndns Subscribe and Update DynDNS Hosts - user Manage users - tools Specific tools - -optional arguments: - -h, --help Show this help message and exit - -v, --version Display moulinette version +yunohost app install wordpress --label Webmail + ^ ^ ^ ^ + | | | | + category action argument options ``` -### domain +Don't hesitate to browse and ask for more information about a given category or action using the the `--help` option. For instance, those commands : + ```bash -yunohost domain [-h] {info,add,list,remove} - info Get domain information - add Create a custom domain - list List domains - remove Delete domains +yunohost --help +yunohost user --help +yunohost user create --help ``` -### monitor -```bash -yunohost monitor [-h] {enable,network,show-stats,update-stats,disk,system,disable} - enable Enable server monitoring - network Monitor network interfaces - show-stats Show monitoring statistics - update-stats Update monitoring statistics - disk Monitor disk space and usage - system Monitor system information and usage - disable Disable server monitoring -``` - -### service -```bash -yunohost service [-h] {status,start,enable,log,stop,disable} - status Show status information about one or more services - (all by default) - start Start one or more services - enable Enable one or more services - log Log every log file of a service - stop Stop one or more services - disable Disable one or more services -``` - -### firewall -```bash -yunohost firewall [-h]{installupnp,checkupnp,list,stop,disallow,reload,allow,removeupnp} - installupnp Add uPnP cron - checkupnp Check if uPnP is installed or not (0 yes 1 no) - list List all firewall rules - stop Stop iptables and ip6tables - disallow Disallow connection - reload Reload all firewall rules - allow Allow connection port/protocol - removeupnp Remove uPnP cron -``` - -### backup -```bash -yunohost backup [-h] {init} ... - init Initialize Tahoe-LAFS configuration -``` - -### app -```bash -yunohost app [-h] -{map,ssowatconf,install,checkport,listlists,removelist,info,upgrade,service,fetchlist,checkurl,list,remove,removeaccess,setting,initdb,addaccess} - map List apps by domain - ssowatconf Regenerate SSOwat configuration file - install Install apps - checkport Check availability of a local port - listlists List fetched lists - removelist Remove list from the repositories - info Get app info - upgrade Upgrade app - service Add or remove a YunoHost monitored service - fetchlist Fetch application list from app server - checkurl Check availability of a web path - list List apps - remove Remove app - removeaccess Revoke access rights to users (everyone by default) - setting Set or get an app setting value - initdb Create database and initialize it with optionnal - attached script - addaccess Grant access rights to users (everyone by default) -``` - -### hook -```bash -yunohost hook [-h] {callback,add,check,remove,exec} ... - callback Execute all scripts bound to an action - add Store hook script to filesystem - check Parse the script file and get arguments - remove Remove hook scripts from filesystem - exec Execute hook from a file with arguments -``` - -### dyndns -```bash -yunohost dyndns [-h] {subscribe,update,installcron,removecron} ... - subscribe Subscribe to a DynDNS service - update Update IP on a DynDNS platform - installcron Install IP update cron - removecron Remove IP update cron -``` - -### user -```bash -yunohost user [-h] {info,create,list,update,delete} ... - info Get user information - create Create user - list List users - update Update user information - delete Delete user -``` - -### tools -```bash -yunohost tools [-h] {postinstall,maindomain,ldapinit,adminpw} ... - postinstall YunoHost post-install - maindomain Main domain change tool - ldapinit YunoHost LDAP initialization - adminpw Change admin password # Existing password required. See workaround below. -``` - - -### admin -```bash -yunohost-reset-ldap-password Reset the admin account (Web GUI) password -``` \ No newline at end of file +will successively list all the categories available, then the actions available in the `user` category, then the usage of the action `user create`. You might notice that the YunoHost command tree is built with a structure similar to the YunoHost admin pages. diff --git a/commandline_fr.md b/commandline_fr.md index ff714789..2447ba16 100644 --- a/commandline_fr.md +++ b/commandline_fr.md @@ -1,52 +1,30 @@ -# Moulinette +# Administrer YunoHost en ligne de commande -La **Moulinette** est l’interface en ligne de commande (CLI) de YunoHost. Elle permet de gérer entièrement YunoHost : utilisateurs, domaines, applications, pare-feu, sauvegardes et monitoring. +L'interface en ligne de commande (CLI) est, en informatique, la manière original (et plus technique) d'interagir avec un ordinateur comparé aux interfaces graphique. La ligne de commande est généralement considéré comme plus complète, puissante et efficace que les interface graphique, bien que plus difficile à apprendre. -L’autre interface est l’[administration web](/admin_fr), qui permet de se passer de la ligne de commande. +Dans le contexte de YunoHost, ou de l'administration système en général, la ligne de commande est communément utilisée après s'être [connecté en SSH](/ssh). -Pour utiliser la Moulinette il faut se connecter à son serveur en [SSH](/ssh_fr). +
+Fournir un tutorial complet sur la ligne de commande est bien au dela du cadre de la documentation de YunoHost : pour cela, référez-vous à des tutoriaux comme [celui-ci](https://doc.ubuntu-fr.org/tutoriel/console_ligne_de_commande) ou [celui-ci (en)](http://linuxcommand.org/). Mais soyez rassurer qu'il n'y a pas besoin d'être un expert pour commencer à l'utiliser ! +
-### Utilisation +La commande `yunohost` peut être utilisée pour administrer votre serveur ou réaliser les mêmes actions que celles disponibles sur la webadmin. Elle doit être lancée en depuis l'utilisateur `root`, ou bien depuis l'utilisateur `admin` en précédant la commande de `sudo`. (ProTip™ : il est possible de devenir `root` via la commande `sudo su` en tant qu'`admin`.) + +Les commandes YunoHost ont ce type de structure : -La moulinette fonctionne avec deux niveaux de sous-commandes, par exemple : ```bash -yunohost user create +yunohost app install wordpress --label Webmail + ^ ^ ^ ^ + | | | | + categorie action argument options ``` -Vous pouvez y adjoindre des arguments pour certaines commandes : -```bash -yunohost app install roundcube --label Webmail -``` +N'hesitez pas à naviguer et demander des informations à propos d'une catégorie ou action donnée via l'option `--help`. Par exemple, ces commandes : -Pour obtenir de l’aide à tout moment sur l’utilisation d’une commande ou d’une sous-commande, vous pouvez ajouter ```-h``` ou ```--help``` à la commande. Essayez par exemple : ```bash yunohost --help yunohost user --help yunohost user create --help ``` ---- - -Ça y est, vous savez utiliser la moulinette ! N’hésitez pas à parcourir ses fonctions. -```bash -root@yunohost:~# yunohost --help -usage: yunohost [-h] [-v] - {domain,monitor,firewall,backup,app,hook,dyndns,user,tools} - ... - -positional arguments: - {domain,monitor,firewall,backup,app,hook,dyndns,user,tools} - domain Manage domains - monitor Monitoring functions - firewall Manage firewall rules - backup Manage backups - app Manage apps - hook Manage hooks - dyndns Subscribe and Update DynDNS Hosts - user Manage users - tools Specific tools - -optional arguments: - -h, --help show this help message and exit - -v, --version Display YunoHost version -``` +vont successivement lister toutes les catégories disponibles, puis les actions de la catégorie `user`, puis expliquer comment utiliser l'action `user create`. Vous devriez remarquer que l'arbre des commandes YunoHost suit une structure similaire aux pages de la webadmin. diff --git a/domains.md b/domains.md new file mode 100644 index 00000000..0b1d48d4 --- /dev/null +++ b/domains.md @@ -0,0 +1,47 @@ +Domains, DNS conf and certificate +================================= + +YunoHost allows to manage and serve several domains on the same server. You can therefore host, for instance, a blog and a Nextcloud on a first domain `yolo.com`, and a web mail client on a second domain `swag.nohost.me`. Each domain is automatically configured to be able to handle web services, mail services and XMPP services. + +Domains can be managed in the 'Domain' section of the webadmin, or through the `yunohost domain` category of the command line. Each time you add a domain, it is expected that you bought it (or own it) on a domain registrar, such that you will then be able to manage the [DNS configuration](dns). The exception is the domains `.nohost.me`, `.noho.st` and `ynh.fr` which are free and can be directly integrated with YunoHost. + +The domain chosed during the postinstall is defined as the main domain of the server : this is where the SSO and the web admin interface will be available. The main domain can later be changed through the web admin in Domains > (the domain) > Set default, or with the command line `yunohost tools maindomain`. + +Finally, it shall be noted that, in the context of YunoHost, there is no hierarchy between the domains it knows. In the previous example, one may add a third domain `foo.yolo.com` - but it would be considered as a domain independent of `yolo.com`. + +DNS configuration +----------------- + +DNS (Domain Name System) is a system that allows computers from all around the world to translate human-readable domain name (such as `yolo.com`) to machine-understandable adresses called IP (such as `11.22.33.44`). For this translation (and other features) to work, one must carefully configure DNS records. + +YunoHost can generate a recommended DNS configuration for each domain, including elements needed for mail and XMPP. The recommended DNS configuration is available in the webadmin via Domain > (the domain) > DNS configuration, or with the command `yunohost domain dns-conf the.domain.tld`. + +SSL/HTTPS certificates +---------------------- + +Another important aspect of domain configuration is the SSL/HTTPS certificate. YunoHost is integrated with Let's Encrypt, such that once your server is correctly reachable from anybody on the internet though the domain name, the administrator can ask to install a Let's Encrypt certificate. See the documentation about [certificates](certificates) for more information. + +Subpaths vs. individual domains per apps +---------------------------------------- + +In the context of YunoHost, it is quite common to have a single (or a few) domains on which several apps are installed in "subpaths", such that you end up with something like this : + +```bash +yolo.com + ├── /blog : Wordpress (a blog) + ├── /cloud : Nextcloud (a cloud service) + ├── /rss : TinyTiny RSS (a RSS reader) + ├── /wiki : DokuWiki (a wiki) +``` + +Alternatively, one may choose to install each (or some) apps on a dedicated domain. This might look prettier for end users, but is generally considered more complicated and less efficient in the context of YunoHost, for you need to add a new domain each time. Nevertheless, some apps might need an entire domain dedicated to them, for technical reason. + +If all apps from the previous example would be installed on a separate domain, this would give something like this : + +```bash +blog.yolo.com : Wordpress (a blog) +cloud.yolo.com : Nextcloud (a cloud service) +rss.yolo.com : TinyTiny RSS (a RSS reader) +wiki.yolo.com : DokuWiki (a wiki) +``` + diff --git a/domains_fr.md b/domains_fr.md new file mode 100644 index 00000000..c90deb6e --- /dev/null +++ b/domains_fr.md @@ -0,0 +1,46 @@ +Domaines, configuration DNS et certificats +========================================== + +YunoHost permet de gérer et de servir plusieurs domaines sur un même serveur. Vous pouvez donc héberger, par exemple, un blog et un Nextcloud sur un premier domaine `yolo.com`, et un client de messagerie web sur un second domaine `swag.nohost.me`. Chaque domaine est automatiquement configuré pour pouvoir gérer des services web, des courriels et une messagerie instantannée XMPP. + +Les domaines peuvent être gérés dans la section 'Domaine' de la webadmin, ou via la catégorie `yunohost domain` de la ligne de commande. Chaque fois que vous ajoutez un domaine, il est supposé que vous avez acheté (ou en tout cas que vous contrôliez) le domaine, de sorte que vous puissiez gérer la [configuration DNS](dns) ce celui-ci. Une exception concerne les domaines en `.nohost.me`, `.noho.st` et `ynh.fr` qui sont gratuits et peuvent être directement intégrés avec YunoHost. + +Le domaine choisi lors de la postinstall est défini comme le domaine principal du serveur : c'est là que le SSO et l'interface d'administration web seront disponibles. Le domaine principal peut être modifié ultérieurement via la webadmin dans Domaines > (le domaine) > Définir par défaut, ou avec la ligne de commande `yunohost tools maindomain`. + +Enfin, il faut noter que, dans le contexte de YunoHost, il n'y a pas de hiérarchie entre les domaines qu'il connaît. Dans l'exemple précédent, on peut ajouter un troisième domaine `foo.yolo.com` - mais il serait considéré comme un domaine indépendant de `yolo.com`. + +Configuration DNS +----------------- + +DNS (Domain Name System) est un système qui permet aux ordinateurs du monde entier de traduire les noms de domaine lisibles par l'homme (comme `yolo.com`) en adresses IP compréhensibles par les machines (comme `11.22.33.44`). Pour que cette traduction (et d'autres fonctionnalités) fonctionne, il faut configurer soigneusement les enregistrements DNS. + +YunoHost peut générer une configuration DNS recommandée pour chaque domaine, y compris les enregistrements nécessaires pour les parties emails et XMPP. La configuration DNS recommandée est disponible dans l'administrateur web via Domaine > (le domaine) > configuration DNS, ou avec la commande `yunohost domain dns-conf the.domain.tld`. + +Certificats SSL/HTTPS +---------------------- + +Un autre aspect important de la configuration des domaines est le certificat SSL/HTTPS. YunoHost est intégré avec Let's Encrypt, de sorte qu'une fois que votre serveur est correctement accessible depuis n'importe qui sur Internet via le nom de domaine, l'administrateur peut demander l'installation d'un certificat Let's Encrypt. Voir la documentation sur les [certificats](certificats) pour plus d'informations. + +Sous-chemins vs. domaines individuels par application +----------------------------------------------------- + +Dans le contexte de YunoHost, il est assez courant d'avoir un seul (ou quelques) domaines sur lesquels plusieurs applications sont installées dans des "sous-chemins", de sorte que l'on se retrouve avec quelque chose comme ceci : + +````bash +yolo.com + ├─── /blog : Wordpress (un blog) + ├─── /cloud : Nextcloud (un service de cloud) + ├─── /rss : TinyTiny RSS (un lecteur RSS) + ├─── /wiki : DokuWiki (un wiki) +``` + +Alternativement, on peut choisir d'installer chaque application (ou certaines) sur un domaine dédié. Cela peut sembler plus joli pour les utilisateurs finaux, mais est généralement considéré comme plus compliqué et moins efficace dans le contexte de YunoHost, car vous devez ajouter un nouveau domaine à chaque fois. Néanmoins, certaines applications peuvent avoir besoin d'un domaine entier qui leur est dédié, pour des raisons techniques. + +Si toutes les applications de l'exemple précédent étaient installées sur un domaine séparé, cela donnerait quelque chose comme ceci : + +````bash +blog.yolo.com : Wordpress (un blog) +cloud.yolo.com : Nextcloud (un service de cloud) +rss.yolo.com : TinyTiny RSS (un lecteur RSS) +wiki.yolo.com : DokuWiki (un wiki) +``` diff --git a/email.md b/email.md new file mode 100644 index 00000000..a16dec19 --- /dev/null +++ b/email.md @@ -0,0 +1,43 @@ +Emails +====== + +YunoHost comes with a complete mail stack allowing you to host your own email server, and therefore to have your own email addresses in `something@your.domain.tld`. + +The mail stack includes a SMTP server (postfix), an IMAP server (Dovecot), an antispam (rspamd) and DKIM configuration. + +Making sure your setup is right +------------------------------- + +Mails are a complicated ecosystem and quite a lot of details can cause them to not work properly. + +To validate that your setup is right : +- if you are self-hosting at home and not using a VPN, make sur [your ISP won't block port 25](isp) ; +- route ports according to [this documentation](isp_box_config) ; +- carefully configure mail DNS records according [this documentation](dns_config) ; +- test your setup using [Mail-tester.com](https://mail-tester.com) (be careful : only 3 tests per domain per day are allowed) ; + +A score of at least 8~9/10 is a reasonnable goal. + +Email clients +------------- + +To interact with the email sever (read and send emails), you can either install a webclient such as Roundcube or Rainloop on your serveur - or configure a desktop/mobile client as described in [this page](email_configure_client). + +Desktop and mobile clients have the advantage of copying your emails to the equipment, allowing offline consultation and relative protection against possible hardware failures of your server. + +Configuring email aliases and auto-forwards +------------------------------------------- + +Mail aliases and forwards can be configured for each users. For instance, the first user created on the server automatically has an alias `root@the.domain.tld` configured - meaning that sending email to this adress will end in the inbox of this user. Automatic forwards may be configured, for instance if an user doesn't want to configure an additional email account and just want to receive emails from the server on, say, his/her gmail address. + +Another feature which few people know about is the use of suffixes beginning with "+". For example, emails sent to `johndoe+booking@votre.domaine.tld` will land in John Doe's mailbox. It is a practical technique for example to provide an e-mail address to a website, then easily sort (via automatic filters) the mail coming from this website. + +What happens if my server becomes unavailable ? +----------------------------------------------- + +If your server becomes unavailable, emails sent to your server will stay in a pending queue on the sender's side for as long as ~5 days. The sender's hoster will regularly try to resend the mail, until it drops it if it was unable to send it. + +Migrating email from an email provider to a YunoHost instance +------------------------------------------------------------- + +See [this page](email_migration). diff --git a/email_fr.md b/email_fr.md index 93ea96de..37649e7b 100644 --- a/email_fr.md +++ b/email_fr.md @@ -1,58 +1,45 @@ -# Messagerie électronique +Emails +====== -### Relever ses courriels -#### Le webmail Rouncube -Pour relever simplement ses [courriels](https://fr.wikipedia.org/wiki/Courrier_%C3%A9lectronique), le client webmail [Rouncube](https://roundcube.net/) est proposé dans YunoHost. Il est installable depuis l’interface d’administration : +YunoHost est livré avec un écosystème complet de serveur mail, vous permettant d'héberger votre propre serveur de messagerie, et donc d'avoir vos propres adresses email dans `quelquechose@votre.domaine.tld`. - +Cet écosystème comprends un serveur SMTP (postfix), un serveur IMAP (Dovecot), un antispam (rspamd) et une configuration DKIM. -#### Client de messagerie alternatif -Vous pouvez également configurer un [client de messagerie indépendant](email_configure_client_fr), pour par exemple relever les messages de plusieurs adresses de courriel simultanément ou [relever vos courriels depuis un smartphone](email_configure_client_fr#Android). +S'assurer que votre configuration est correcte +------------------------------- -#### Transférer ou migrer ses mails vers un autre serveur -Suivez [ce guide](email_migration_fr) pour transférer vos mails sur votre serveur YunoHost en utilisant le protocole IMAP. +Les emails sont un écosystème compliqué et un grand nombre de détails peuvent les empêcher de fonctionner correctement. -### Configurations supplémentaires pour la messagerie -#### Configurer les DNS MX -Si vous avez opté pour un nom de domaine personnel, il est nécessaire de [configurer votre serveur DNS](/dns_config_fr) pour faire fonctionner la messagerie électronique. +Pour valider que votre configuration est correcte : +- si vous vous hébergez chez vous et n'utilisez pas de VPN, assurez-vous que [votre FAI ne bloque pas le port 25](isp) ; +- routez les ports selon [cette documentation](isp_box_config) ; +- configurez soigneusement les enregistrements DNS du courrier électronique selon [cette documentation](dns_config) ; +- Testez votre configuration en utilisant [Mail-tester.com](https://mail-tester.com) (attention : seuls 3 tests par domaine et par jour sont autorisés) ; -#### Ouverture des ports -Vérifiez également que les ports correspondant à la messagerie (n° 25, 587 et 993) sont bien ouverts au niveau de votre box ou de votre routeur. [Tutoriel d’ouverture des ports de la box](/isp_box_config_fr). +Un score d'au moins 8~9/10 est un but raisonnable. -#### Configurer l’authentification DKIM/SPF (facultatif) -Le protocole SMTP ne prévoit pas de mécanisme de vérification de l’expéditeur. Il est donc possible d’envoyer un courrier avec une adresse d’expéditeur factice ou usurpée. SPF et DKIM sont deux mécanismes possibles d’authentification de l’expéditeur d’un email. [Tutoriel pour configurer DKIM/SPF](dkim_fr). +Clients de messagerie +------------- -### Résolution de problèmes -#### Votre serveur est sur une liste noire… -Si les courriels envoyés à un type d’adresse spécifique (par exemple les adresses Gmail) n’arrivent pas à destination, votre serveur (son adresse IP) a peut être été ajouté à la liste noire du fournisseur d’adresse courriel en question. Pour résoudre ce problème voici les [formulaires de retrait des listes noires](blacklist_forms_fr). +Pour interagir avec le serveur de mail, c'est-à-dire lire et envoyer des emails, vous pouvez soit installer un client web comme Roundcube ou Rainloop sur votre serveur - ou configurer un client de bureau ou mobile comme décrit dans [cette page](email_configure_client). -#### Consulter les fichiers de log pour identifier le problème -De nombreux messages permettant d’identifier les problèmes se trouvent enregistrés dans les fichiers de log du système. Apprenez à les consulter, pour pouvoir mieux comprendre ce qui cloche et trouver de l’aide sur le forum ou le salon de support. +Les clients de bureau ou mobile ont l'avantage de copier vos emails sur l'équipement permettant ainsi la consultation hors ligne et une protection relative face à d'éventuelles pannes matériel de votre serveur. - +Configuration des alias de messagerie et des redirections automatiques +------------------------------------------- -#### Je suis capable de recevoir mais pas d'envoyer des mails +Des alias de messagerie et des redirections peuvent être configurés pour chaque utilisateur. Par exemple, le premier utilisateur créé sur le serveur dispose automatiquement d'un alias `root@votre.domaine.tld` - ce qui signifie qu'un email envoyé vers cette adresse se retrouvera dans la boîte de réception de cet utilisateur. Les redirections automatiques peuvent être configurées, par exemple si un utilisateur ne veut pas configurer un compte de messagerie supplémentaire et souhaite simplement recevoir des courriels du serveur sur, disons, son adresse gmail. -Cela peut être dû au fait que le port 25 est fermé, et que votre fournisseur d'accès internet ne vous permet pas de l'ouvrir (pour lutter contre le spam)... +Une autre fonctionnalité méconnue est l'utilisation de suffixe commencant par "+". Par exemple, les emails envoyés à `johndoe+sncf@votre.domaine.tld` atteriront dans la boîte mail de John Doe. C'est une technique pratique pour par exemple fournir une adresse mail à un site puis facilement trier (via des filtres automatiques) les courriers venant de ce site. -Une solution de contournement consiste, soit à utiliser un VPN (ce qui nécessitera un abonnement chez un fournisseur, et de configurer l'app vpnclient), soit à utiliser un relai SMTP. +Que se passe-t-il si mon serveur devient indisponible ? +----------------------------------------------- -Attention : dans le cas d'un relai SMTP, ***la personne ou l'organisme qui possède le relai sera techniquement très facilement capable de lire tout mail non-chiffré transitant entre votre serveur et le reste d'Internet ! Vous lui faites donc confiance à propos de toute information personelle ou critique que pourrait contenir vos mails !*** +Si votre serveur devient indisponible, les courriels envoyés à votre serveur resteront dans une file d'attente du côté de l'expéditeur pendant environ 5 jours. L'hébergeur de l'expéditeur tentera régulièrement de renvoyer le courrier, jusqu'à ce qu'il le jette s'il n'a pas pu l'envoyer. -Pour mettre en place le relai SMTP, il faut modifier le fichier `/etc/postfix/main.cf`. -Chercher la ligne contenant `relayhost = ` et la remplacer par `relayhost = smtp..tld`. Par exemple: `relayhost = smtp.free.tld`. -Si la ligne n'existe pas ajouter la ligne à la fin du fichier. -**Plus d'informations** -- https://yunohost.org/#/isp_fr -- https://yunohost.org/#/isp_orange_fr -- https://yunohost.org/#/isp_sfr_fr -- https://yunohost.org/#/isp_free_fr +Pour aller plus loin +-------------------- -### Aller plus loin -La messagerie électronique est basée sur les protocoles SMTP pour l’envoi de mail et IMAP (ou anciennement POP3) pour la récupération des messages depuis un serveur. En arrière-plan, YunoHost fournit : -* [Postfix](http://www.postfix.org) en tant que serveur SMTP. -* [Dovecot](http://www.dovecot.org) pour le serveur IMAP. -* [Rspamd](https://rspamd.com) logiciel antispam, filtrant les messages indésirables. - -Pour approfondir votre compréhension du courriel et de ses protocoles, voici une [conférence éclairante](http://www.iletaitunefoisinternet.fr/lemail-par-benjamin-sonntag/index.html)(en français). +- Il existe une page de documentation pour [migrer ses emails d'un fournisseur de messagerie vers une instance YunoHost](email_migration). +- Pour approfondir votre compréhension du courriel et de ses protocoles, voici une [conférence éclairante](http://www.iletaitunefoisinternet.fr/lemail-par-benjamin-sonntag/index.html)(en français). diff --git a/guidelines.md b/guidelines.md new file mode 100644 index 00000000..45478bab --- /dev/null +++ b/guidelines.md @@ -0,0 +1,49 @@ +# Advices and guidelines + +This page lists a few advices and guidelines which every YunoHost administrator should be aware to take care of a YunoHost server :). + +## Do not break YunoHost + +To put it another way : your server is either a production server (meant to work) or a test server on which you allow yourself to experiment. + +If your goal is to run a production server, then please : +- be aware that servers are fragile system. Stay cautious, methodical and patient ; +- limit experimentations and customizations (for instance of config file) ; +- do not install dozens of apps just to see how they look ; +- use non-official apps with caution, and do not use apps that are still 'in progress', 'not working' or level 0 ; +- if something gets broken, think twice about fixing it by yourself if you don't know what you are doing. (For instance, do not attempt to recreate yourself the admin user just because it mysteriously disappeared...) + +## Keep it simple ! + +YunoHost is designed to work with general and simple use cases in mind. Deviating from those conditions will make things harder and you will need technical knowledge to make it work. For instance, +- do not try to run YunoHost in a context where you cannot have control over ports 80 and 443 (or no internet at all) ; +- do not try to host five servers behind the same internet connection if you are not already an advanced user ; +- do not fall into nerd whims such as willing to replace nginx by Apache (or run both at the same time) ; +- do not try to use custom SSL certificates if you don't really need them ; +- ... + +Keep things as simple as you can ! + +## Do not reinstall every day + +Some people tend to fall into "the reinstallation spiral" - where each time something breaks in the server and it is not obvious how to fix it, or because the server became "dirty", one ends up reinstalling the whole server from scratch because it looks like an "easy" and quick solution to clean the table. + +Please don't do this. Reinstalling is a heavy operation and is not a good long-term strategy for fixing problems. You will get tired and won't learn anything. Forget the dream of having a "clean" server. A real-life server always end up being a bit "dirty". Also, you need to (progressively) learn how to solve issues when you encounter them. Reach for [help](/help) with detailed symptoms of what you are trying to do and what is happening, and fix the issues. Over time, you will get a much better control over your server than just blindly reinstalling every time. + +## Do backups + +If you host services and data that are important for your users, it is important that you setup a backup policy. Backups can be easily created from the webadmin - though they currently cannot be downloaded from it (but it can be downloaded through other means). You should perform backup regularly and keep them in a safe and different physical location from your server. More info on [the backup documentation](/backup) + +## Check root's email + +As an administrator, you should configure an email client to check emails sent to `root@your.domain.tld` (which should be an alias to the first user your added) or otherwise forward them to another address that you actively check. Those mails may contain information on what is happening on your server such as automated periodic tasks. + +## YunoHost is free software, maintained by volunteers + +Finally, keep in mind that YunoHost is a free software maintained by volunteers - and that the goal of YunoHost (to democratize self-hosting) is not an easy one ! It is provided without any warranty. The team of volunteers does its best to maintain and provide the best possible experience - yet features, applications and YunoHost as a whole are far from being perfect and you will experience small and big shortcomings at some points. When this happens, kindly [reach for help on the chat or forum, or report the issue](/help) :) ! + +If you like YunoHost and want to see the project being kept alive and make progress, feel free to leave a thank you note and to [donate](https://liberapay.com/YunoHost) to the project and talk about it around you ! + +Last but not least, since YunoHost is a free software project, you are legitimate and welcomed to come and [contribute](/contribute) to the project, be it on the technical aspects (i.e. code) and less-technical aspects (such as contributing to this documentation ;)) ! + + diff --git a/guidelines_fr.md b/guidelines_fr.md new file mode 100644 index 00000000..6083bc32 --- /dev/null +++ b/guidelines_fr.md @@ -0,0 +1,48 @@ +# Conseil généraux + +Cette page énumère quelques conseils et lignes directrices que tout administrateur de YunoHost devrait connaître pour prendre soin de son serveur :). + +## Ne cassez pas YunoHost + +En d'autres termes : votre serveur est soit un "serveur de production" (destiné à fonctionner), soit un serveur de test sur lequel vous vous permettez d'expérimenter. + +Si votre but est d'avoir un serveur de production, alors s'il vous plaît.. : +- soyez conscient qu'un serveur est un système fragile : restez prudent, méthodique et patient ; +- limitez les expérimentations et la personnalisation - notamment des fichiers de config ; +- n'installez pas des douzaines d'applications juste pour voir de quoi elles ont l'air ; +- utilisez les applications non-officielles avec prudence, et interdisez vous d'utiliser celles 'in progress', 'not working' ou qui on un niveau 0 ; +- si quelque chose casse, réfléchissez à deux fois avant de tenter de le réparer vous-même si vous ne savez pas ce que vous faites. (Par exemple, n'essayez pas de recréer vous-même l'utilisateur admin juste parce qu'il a mystérieusement disparu...) + +## Keep it simple ! + +YunoHost est conçu pour fonctionner avec des cas d'utilisation généraux et simples. S'écarter de ces conditions rendra les choses plus difficiles et vous aurez besoin de connaissances techniques pour les faire fonctionner. Par exemple, +- n'essayez pas d'exécuter YunoHost dans un contexte où vous ne pouvez pas avoir le contrôle des ports 80 et 443 (ou pas d'Internet du tout) ; +- n'essayez pas d'héberger cinq serveurs derrière la même connexion Internet si vous n'êtes pas déjà un utilisateur avancé ; +- ne tombez pas dans des caprices de nerd tels que vouloir remplacer nginx par Apache (ou faire tourner les deux à la fois) ; +- n'essayez pas d'utiliser des certificats SSL personnalisés si vous n'en avez pas vraiment besoin ; +- ... + +Gardez les choses aussi simples que possible ! + +## Ne réinstallez pas tous les jours + +Certaines personnes ont tendance à tomber dans la "spirale de la réinstallation" - où chaque fois que quelque chose casse dans le serveur et qu'il n'est pas évident comment le réparer, ou parce que le serveur est devenu "sale", l'administrateur finit par réinstaller le serveur entier à partir de zéro car cela semble une solution "facile" et rapide pour remettre les choses à plat. + +Ne faites pas ça. La réinstallation est une opération lourde et n'est pas une bonne stratégie à long terme pour résoudre les problèmes. Vous vous fatiguerez et n'apprendrez rien. Oubliez le rêve d'avoir un serveur "propre" : un serveur de la vraie vie fini toujours par être "sale". De plus, vous devez apprendre (progressivement) à résoudre les problèmes lorsque vous les rencontrez. [Demandez de l'aide](/help) en fournissant des détails sur les symptômes, ce que vous essayez de faire et de ce qu'il se passe, et corrigez les problèmes. Avec le temps, vous aurez un bien meilleur contrôle sur votre serveur plutôt que réinstaller aveuglément à chaque fois. + +## Faites des sauvegardes + +Si vous hébergez des services et des données qui sont importants pour vos utilisateurs, il est important que vous mettiez en place une politique de sauvegarde. Les sauvegardes peuvent être facilement créées à partir de l'interface d'administration web - bien qu'elles ne puissent actuellement pas être téléchargées à partir de celle-ci (mais elles peuvent être téléchargées par d'autres moyens). Vous devez effectuer régulièrement des sauvegardes et les conserver dans un endroit sûr et physiquement différent de votre serveur. Plus d'infos dans [la documentation des sauvegardes](/backup) + +## Lisez les emails envoyés à root + +En tant qu'administrateur, vous devriez configurer un client de messagerie pour vérifier les e-mails envoyés à `root@your.domain.tld` (qui doit être un alias pour le premier utilisateur que vous avez ajouté) ou les transférer à une autre adresse que vous vérifiez activement. Ces courriels peuvent contenir des informations sur ce qu'il se passe sur votre serveur, comme les tâches périodiques automatisées. + +## YunoHost est un logiciel gratuit, maintenu par des bénévoles. + +Enfin, gardez à l'esprit que YunoHost est un logiciel libre maintenu par des volontaires - et que le but de YunoHost (démocratiser l'auto-hébergement) n'est pas simple ! Le logiciel n'est fourni sans aucune garantie. L'équipe de bénévoles fait de son mieux pour maintenir et fournir la meilleure expérience possible - pourtant les fonctionnalités, les applications et YunoHost dans son ensemble sont loin d'être parfaits et vous ferez face tôt ou tard à de petit ou gros problèmes. Lorsque cela se produit, venez gentillement [demander de l'aide sur le chat ou le forum, ou signaler le problème](/help) :) ! + +Si vous aimez YunoHost et que vous voulez que le projet soit maintenu en vie et progresse, n'hésitez pas à laisser une note de remerciement et à [faire un don](https://liberapay.com/YunoHost) au projet et à en parler autour de vous ! + +Pour finir, puisque YunoHost est un projet de logiciel libre, vous êtes légitime et bienvenu pour [venir contribuer](/contribute) au projet, que ce soit sur les aspects techniques (i.e. code) et moins techniques (comme par exemple contribuer à cette documentation ;)) ! + diff --git a/howtohostyourself.md b/howtohostyourself.md new file mode 100644 index 00000000..03a5a7c3 --- /dev/null +++ b/howtohostyourself.md @@ -0,0 +1,83 @@ +# How to host yourself ? + +You can host yourself at home (on a small computer), or on a remote server. Each solution has their pros and cons : + +### At home, for instance on an ARM board or an old computer + +You can host yourself at home with an ARM board or a re-purposed regular computer, connected to our home router/box. + +- **Pros** : you will have physical control on 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). + +### At home, behind a VPN + +A VPN is an encrypted tunnel between two machines. In practice, it allows to make it "as is" you were connected to the Internet from somewhere else. This allows to still host yourself at home while bypassing possible limitations from your ISP. See also [the Internet Cube project](https://internetcu.be/) and [the FFDN](https://www.ffdn.org/). + +- **Pros** : you will have physical control on the machine, and the VPN hides your traffic from your ISP and allows to bypass its limitations ; +- **Cons** : you will have to pay a monthly subscription for the VPN. + +### On a remote server (VPS or dedicated server) + +You can rent a virtual private server or a dedicated machine to [associative](https://db.ffdn.org/) or commercial "Cloud" providers. + +- **Pros** : your server and its internet connectivity will be fast ; +- **Cons** : you will have to pay a monthly subscription and won't have physical control on your server. + +### Summary + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
At home
(e.g. ARM board, old computer)		At home
behind a VPN		On a remote server
(VPS or dedicated)
Hardware costAbout 50€
(e.g. a Raspberry Pi)		None
Monthly costNeglictible
(electricity)		Around 5€
(VPN)		Starting at ~3€
(VPS)
Physical control
on the machine		YesYesNo
Manual port
routing required		YesNoNo
Possible ISP limitationsYes
(see [here](/isp))		Bypassed by VPNTypically no
CPUTypically ~1 GHz~2 GHz
(Digital Ocean droplet)
RAMTypically 500 Mo or 1 GoRelated to server cost
Internet connectivityDepends of home connectivityTypically pretty good
diff --git a/howtohostyourself_fr.md b/howtohostyourself_fr.md new file mode 100644 index 00000000..4a78ccc7 --- /dev/null +++ b/howtohostyourself_fr.md @@ -0,0 +1,83 @@ +# Choisir son mode d'autohébergement + +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 : + +### À la maison, par exemple sur une carte ARM ou un ancien ordinateur + +Vous pouvez vous hébergez 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 [configuré 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 + +Un VPN est un tunnel chiffré entre deux machines. En pratique, cela permet de faire "comme si" une machine était connecté depuis ailleurs. Ceci permet de s'auto-héberger à la maison tout en contournant les limitations du fournisseur d'accès internet. Voir aussi [le projet Brique Internet](https://labriqueinter.net/) et [la FFDN](https://www.ffdn.org/). + +- **Avantages** : vous aurez un contrôle physique sur la machine, et le VPN permettra de cacher votre traffic vis-à-vis de votre FAI ainsi que de contourner ses limitations ; +- **Inconvénients** : il vous faudra payer des frais mensuels pour le VPN. + +### Sur un serveur distant (VPS ou serveur dédié) + +Vous pouvez louer un serveur privé virtuel ou une machine dédiée à des hébergeurs [associatifs](https://db.ffdn.org/) ou commerciaux. + +- **Avantages** : votre serveur sera rapide et la connectivité internet sera bonne ; +- **Inconvénients** : il vous faudra payer des frais mensuels pour la machine, et vous n'aurez pas de contrôle physique dessus. + +### Résumé + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
À la maison
(e.g. carte ARM, vieil ordi)		À la maison
derrière un VPN		Sur un serveur distantr
(VPS ou dédié)
Coût matérielAutour de 50€
(e.g. un Raspberry Pi)		Aucun
Coût mensuelNegligeable
(electricité)		Autour de 5€
(VPN)		À partir de ~3€
(VPS)
Contrôle physique
sur la machine		OuiOuiNon
Routage manuel
des ports		OuiNonNon
Limitation possibles
par le FAI		Oui
(voir [ici](/isp))		Contournées par le VPNGénéralement non
CPUGénéralement ~1 GHz~2 GHz
(droplet Digital Ocean)
RAMGeneralement 500 Mo ou 1 GoEn fonction du prix
Connectivité internetDépends de la connexionGéneralement bonne
diff --git a/images/Black_YunoHost_logo.png b/images/Black_YunoHost_logo.png deleted file mode 100644 index 9d017077..00000000 Binary files a/images/Black_YunoHost_logo.png and /dev/null differ diff --git a/images/Etherpad.svg b/images/Etherpad.svg deleted file mode 100644 index 193ac68b..00000000 --- a/images/Etherpad.svg +++ /dev/null @@ -1,34 +0,0 @@ - - - Etherpad - - - - image/svg+xml - - Etherpad - 2012-11-20 - - - Marcel Klehr - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/Icons_mumble.svg b/images/Icons_mumble.svg deleted file mode 100644 index 955de468..00000000 --- a/images/Icons_mumble.svg +++ /dev/null @@ -1,463 +0,0 @@ - - - - Mumble logo - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - Mumble logo - 2009.08.17 - - - Martin Skilnand - - - - - Martin Skilnand - - - - - Mumble team - - - mumble.svg - git://mumble.git.sourceforge.net/gitroot/mumble - Logo for voice chat program mumble - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/Let's_Encrypt.svg b/images/Let's_Encrypt.svg deleted file mode 100644 index 069fc6c4..00000000 --- a/images/Let's_Encrypt.svg +++ /dev/null @@ -1,38 +0,0 @@ - - - - - Layer 1 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/Lutim_small.png b/images/Lutim_small.png deleted file mode 100644 index 0da64819..00000000 Binary files a/images/Lutim_small.png and /dev/null differ diff --git a/images/MediaWiki_logo_without_tagline.svg b/images/MediaWiki_logo_without_tagline.svg deleted file mode 100644 index 31dc2772..00000000 --- a/images/MediaWiki_logo_without_tagline.svg +++ /dev/null @@ -1,137 +0,0 @@ - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/Moulin_Legume.jpg b/images/Moulin_Legume.jpg deleted file mode 100644 index d71ae792..00000000 Binary files a/images/Moulin_Legume.jpg and /dev/null differ diff --git a/images/Nextcloud_Logo.svg b/images/Nextcloud_Logo.svg deleted file mode 100644 index 628c9537..00000000 --- a/images/Nextcloud_Logo.svg +++ /dev/null @@ -1,103 +0,0 @@ - - - -image/svg+xml \ No newline at end of file diff --git a/images/OVH1_domain_select.png b/images/OVH1_domain_select.png deleted file mode 100644 index c75fd543..00000000 Binary files a/images/OVH1_domain_select.png and /dev/null differ diff --git a/images/OVH2_domain_DNS.png b/images/OVH2_domain_DNS.png deleted file mode 100644 index 619e4740..00000000 Binary files a/images/OVH2_domain_DNS.png and /dev/null differ diff --git a/images/OVH3_zoneDNS.png b/images/OVH3_zoneDNS.png deleted file mode 100644 index afbe6cca..00000000 Binary files a/images/OVH3_zoneDNS.png and /dev/null differ diff --git a/images/Octicons-mark-github.svg b/images/Octicons-mark-github.svg deleted file mode 100644 index 21e4f07b..00000000 --- a/images/Octicons-mark-github.svg +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/images/PluXml-logo_transparent.png b/images/PluXml-logo_transparent.png deleted file mode 100644 index 093bc8b7..00000000 Binary files a/images/PluXml-logo_transparent.png and /dev/null differ diff --git a/images/Raspberry_Pi_-_Model_A.jpg b/images/Raspberry_Pi_-_Model_A.jpg deleted file mode 100644 index 091741fd..00000000 Binary files a/images/Raspberry_Pi_-_Model_A.jpg and /dev/null differ diff --git a/images/Raspberry_Pi_2_Model_B_v1.1_front_angle_new.jpg b/images/Raspberry_Pi_2_Model_B_v1.1_front_angle_new.jpg deleted file mode 100644 index 29471d28..00000000 Binary files a/images/Raspberry_Pi_2_Model_B_v1.1_front_angle_new.jpg and /dev/null differ diff --git a/images/Searx_logo.svg b/images/Searx_logo.svg deleted file mode 100644 index 302d6c3f..00000000 --- a/images/Searx_logo.svg +++ /dev/null @@ -1,40 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/White_YunoHost_logo.png b/images/White_YunoHost_logo.png deleted file mode 100644 index b6d13400..00000000 Binary files a/images/White_YunoHost_logo.png and /dev/null differ diff --git a/images/Wikipedia-logo-v2-fr.svg b/images/Wikipedia-logo-v2-fr.svg deleted file mode 100644 index 0479eb87..00000000 --- a/images/Wikipedia-logo-v2-fr.svg +++ /dev/null @@ -1,575 +0,0 @@ - - -image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/images/YunoHost_logo_vertical.png b/images/YunoHost_logo_vertical.png index 0307263a..2472cb1f 100644 Binary files a/images/YunoHost_logo_vertical.png and b/images/YunoHost_logo_vertical.png differ diff --git a/images/Zeronet_logo.png b/images/Zeronet_logo.png deleted file mode 100644 index a8c7de2b..00000000 Binary files a/images/Zeronet_logo.png and /dev/null differ diff --git a/images/bitcoin.png b/images/bitcoin.png deleted file mode 100644 index b4fe3248..00000000 Binary files a/images/bitcoin.png and /dev/null differ diff --git a/images/digitalocean.png b/images/digitalocean.png deleted file mode 100644 index 06f172df..00000000 Binary files a/images/digitalocean.png and /dev/null differ diff --git a/images/docker.png b/images/docker.png deleted file mode 100644 index 780a8d5c..00000000 Binary files a/images/docker.png and /dev/null differ diff --git a/images/dovecot.png b/images/dovecot.png deleted file mode 100644 index c84a60b1..00000000 Binary files a/images/dovecot.png and /dev/null differ diff --git a/images/duniter-logo.svg b/images/duniter-logo.svg deleted file mode 100644 index 68aa64c3..00000000 --- a/images/duniter-logo.svg +++ /dev/null @@ -1,279 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/ecosystem.odg b/images/ecosystem.odg new file mode 100644 index 00000000..dda07281 Binary files /dev/null and b/images/ecosystem.odg differ diff --git a/images/ecosystem.png b/images/ecosystem.png new file mode 100644 index 00000000..e8021117 Binary files /dev/null and b/images/ecosystem.png differ diff --git a/images/ecosystem_fr.odg b/images/ecosystem_fr.odg new file mode 100644 index 00000000..099a74ab Binary files /dev/null and b/images/ecosystem_fr.odg differ diff --git a/images/ecosystem_fr.png b/images/ecosystem_fr.png new file mode 100644 index 00000000..3c8d4230 Binary files /dev/null and b/images/ecosystem_fr.png differ diff --git a/images/freshrss_logo.png b/images/freshrss_logo.png deleted file mode 100644 index d13b66b5..00000000 Binary files a/images/freshrss_logo.png and /dev/null differ diff --git a/images/github_ribbon.png b/images/github_ribbon.png deleted file mode 100644 index 8fe3a7e1..00000000 Binary files a/images/github_ribbon.png and /dev/null differ diff --git a/images/github_ribbon_red.png b/images/github_ribbon_red.png deleted file mode 100644 index 1e19c212..00000000 Binary files a/images/github_ribbon_red.png and /dev/null differ diff --git a/images/icon-debian.png b/images/icon-debian.png new file mode 100644 index 00000000..51283151 Binary files /dev/null and b/images/icon-debian.png differ diff --git a/images/icon-door.png b/images/icon-door.png new file mode 100644 index 00000000..3c950816 Binary files /dev/null and b/images/icon-door.png differ diff --git a/images/icon-globe.png b/images/icon-globe.png new file mode 100644 index 00000000..10efab03 Binary files /dev/null and b/images/icon-globe.png differ diff --git a/images/icon-lock.png b/images/icon-lock.png new file mode 100644 index 00000000..04d5db43 Binary files /dev/null and b/images/icon-lock.png differ diff --git a/images/icon-mail.png b/images/icon-mail.png new file mode 100644 index 00000000..8f190608 Binary files /dev/null and b/images/icon-mail.png differ diff --git a/images/icon-medic.png b/images/icon-medic.png new file mode 100644 index 00000000..2dad2325 Binary files /dev/null and b/images/icon-medic.png differ diff --git a/images/icon-messaging.png b/images/icon-messaging.png new file mode 100644 index 00000000..c8938558 Binary files /dev/null and b/images/icon-messaging.png differ diff --git a/images/icon-package.png b/images/icon-package.png new file mode 100644 index 00000000..fcda8a44 Binary files /dev/null and b/images/icon-package.png differ diff --git a/images/icon-shield.png b/images/icon-shield.png new file mode 100644 index 00000000..4fbc6a59 Binary files /dev/null and b/images/icon-shield.png differ diff --git a/images/icon-tools.png b/images/icon-tools.png new file mode 100644 index 00000000..2b7c33b2 Binary files /dev/null and b/images/icon-tools.png differ diff --git a/images/icon-users.png b/images/icon-users.png new file mode 100644 index 00000000..4929acac Binary files /dev/null and b/images/icon-users.png differ diff --git a/images/icon.png b/images/icon.png deleted file mode 100644 index b710537f..00000000 Binary files a/images/icon.png and /dev/null differ diff --git a/images/install_script.png b/images/install_script.png deleted file mode 100644 index b43b9e41..00000000 Binary files a/images/install_script.png and /dev/null differ diff --git a/images/logo-jirafeau.jpeg b/images/logo-jirafeau.jpeg deleted file mode 100644 index 35b106cb..00000000 Binary files a/images/logo-jirafeau.jpeg and /dev/null differ diff --git a/images/metronome-logo-180x180.png b/images/metronome-logo-180x180.png deleted file mode 100644 index ac1ef0cb..00000000 Binary files a/images/metronome-logo-180x180.png and /dev/null differ diff --git a/images/movim_logo.png b/images/movim_logo.png deleted file mode 100644 index c0189a1f..00000000 Binary files a/images/movim_logo.png and /dev/null differ diff --git a/images/nginx.png b/images/nginx.png deleted file mode 100644 index bf53cfdd..00000000 Binary files a/images/nginx.png and /dev/null differ diff --git a/images/openldap.png b/images/openldap.png deleted file mode 100644 index a2f5eae2..00000000 Binary files a/images/openldap.png and /dev/null differ diff --git a/images/postfix.png b/images/postfix.png deleted file mode 100644 index 004d971c..00000000 Binary files a/images/postfix.png and /dev/null differ diff --git a/images/postinstall.png b/images/postinstall.png deleted file mode 100644 index b395993f..00000000 Binary files a/images/postinstall.png and /dev/null differ diff --git a/images/privatebin_icon.svg b/images/privatebin_icon.svg deleted file mode 100644 index d63c65db..00000000 --- a/images/privatebin_icon.svg +++ /dev/null @@ -1 +0,0 @@ - diff --git a/images/rainloop_logo.png b/images/rainloop_logo.png deleted file mode 100644 index 1cb320c2..00000000 Binary files a/images/rainloop_logo.png and /dev/null differ diff --git a/images/raspberry-pi-model-b.jpg b/images/raspberry-pi-model-b.jpg deleted file mode 100644 index b8efb3dd..00000000 Binary files a/images/raspberry-pi-model-b.jpg and /dev/null differ diff --git a/images/rspamd.png b/images/rspamd.png deleted file mode 100644 index 70f352da..00000000 Binary files a/images/rspamd.png and /dev/null differ diff --git a/images/spamassassin.png b/images/spamassassin.png deleted file mode 100644 index 493214fb..00000000 Binary files a/images/spamassassin.png and /dev/null differ diff --git a/images/thisisinternet.png b/images/thisisinternet.png deleted file mode 100644 index 5069c622..00000000 Binary files a/images/thisisinternet.png and /dev/null differ diff --git a/images/web4all.png b/images/web4all.png deleted file mode 100644 index 983866e8..00000000 Binary files a/images/web4all.png and /dev/null differ diff --git a/images/win32diskimager.png b/images/win32diskimager.png deleted file mode 100644 index dac54a00..00000000 Binary files a/images/win32diskimager.png and /dev/null differ diff --git a/images/wordpress.png b/images/wordpress.png deleted file mode 100644 index fb3c3926..00000000 Binary files a/images/wordpress.png and /dev/null differ diff --git a/images/ynh_logo_black.png b/images/ynh_logo_black.png deleted file mode 100644 index 426f7f38..00000000 Binary files a/images/ynh_logo_black.png and /dev/null differ diff --git a/images/ynh_logo_white.png b/images/ynh_logo_white.png deleted file mode 100644 index 2134d344..00000000 Binary files a/images/ynh_logo_white.png and /dev/null differ diff --git a/images/ynhadmin_icon.png b/images/ynhadmin_icon.png deleted file mode 100644 index 5846a537..00000000 Binary files a/images/ynhadmin_icon.png and /dev/null differ diff --git a/index.md b/index.md index 433becd9..81c8b7cd 100644 --- a/index.md +++ b/index.md @@ -1,7 +1,7 @@
diff --git a/index_ar.md b/index_ar.md index 3d00694a..fa110ed5 100644 --- a/index_ar.md +++ b/index_ar.md @@ -1,7 +1,7 @@
diff --git a/index_de.md b/index_de.md index dcf01501..50ffd47f 100644 --- a/index_de.md +++ b/index_de.md @@ -1,7 +1,7 @@
diff --git a/index_es.md b/index_es.md index 1a33e69a..9a394618 100644 --- a/index_es.md +++ b/index_es.md @@ -1,7 +1,7 @@
diff --git a/index_fr.md b/index_fr.md index 4c6847dc..7975f234 100644 --- a/index_fr.md +++ b/index_fr.md @@ -1,7 +1,7 @@
diff --git a/overview.md b/overview.md new file mode 100644 index 00000000..81ad2a3d --- /dev/null +++ b/overview.md @@ -0,0 +1,14 @@ +Overview of the YunoHost ecosystem +================================== + +This page provide an overview of the ecosystem of a YunoHost server. While this overview contains several approximations, the purpose here is to introduce the global picture before digging into the different aspects. + +![](images/ecosystem.png) + +Everything starts with the special user **admin**. This is the administrator of the machine who can install, configure and manage things on the server through the web administration interface, or via SSH and the command line interface. *(If you are already familiar with Linux, it is quite similar to root. YunoHost has this additional 'admin' user for several technical reasons.)* + +The administrator can create users and install applications, among other admin actions. Users automatically have their own email adress as well as an XMPP account when they get created. Users will also be able to connect to the user portal (SSO) to access applications. Some applications can typically be installed either as publicly-accessible, or as private, i.e. only some users will have access to it. + +Applications and ther features of the server rely on different services to work properly. Services (sometimes also called daemons) are programs that are constantly running on the server to ensure various tasks are done, such as answering to web requests from web browsers, or relaying emails. + + diff --git a/overview_fr.md b/overview_fr.md new file mode 100644 index 00000000..8461eba5 --- /dev/null +++ b/overview_fr.md @@ -0,0 +1,12 @@ +Vue d'ensemble de l'écosystème YunoHost +======================================= + +Cette page pose une vue d'ensemble de l'écosystème d'un serveur sous YunoHost. Bien que celle-ci contienne des approximations et des raccourcis, elle permet de poser une première représentation générale avant de rentrer plus dans le détail des différents aspects. + +![](images/ecosystem_fr.png) + +Tout commence avec l'utilisateur spécial, **admin**. Il s'agit de l'administrateur de la machine qui peut installer, configurer et gérer le serveur à travers l'interface web d'administration, ou via SSH et la ligne de commande. *(Si vous êtes familier avec Linux, il est similaire à root. YunoHost possède cet utilisateur supplémentaire 'admin' pour plusieurs raisons techniques.)* + +L'administrateur peut créer des utilisateurs et installer des applications, parmis d'autres actions d'administration. Les utilisateurs disposent immédiatement d'une adresse email sur le serveur et d'un compte XMPP. Les utilisateurs peuvent se connecter au portail utilisateur (SSO) pour accéder aux applications. Les applications peuvent typiquement être installées soient en accès public, ou privé, c'est-à-dire que seul les utilisateurs du serveur pourront y accéder. + +Les applications et autres fonctionnalités du serveur reposent sur plusieurs services pour fonctionner proprement. Les services (aussi appelés daemon) sont des programmes qui tournent constamment pour assurer des tâches, telles que répondres aux requêtes web des navigateurs web, ou relayer les emails. diff --git a/selfhosting.md b/selfhosting.md index 83441b95..98f91744 100644 --- a/selfhosting.md +++ b/selfhosting.md @@ -1,43 +1,29 @@ -#Self-hosting +Self-hosting +============ -#### Definition -**Self-hosting** is having a server at home in order to host personnal data and services on it. +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 on, instead of having it on somebody else's computer (a.k.a. The Cloud) in exchange for money, advertisement or private data. -#### Administrator responsibilities -Self-hosting implies responsibilities, if you want to host a website, [emails](email) and have [an instant messaging system](XMPP) running, the server needs to stay online all the time, 24/7. +Self-hosting implies owning a server. A server is a computer which is typically accessible on the network 24/7, and usually does not have any screen or keyboard (it is instead controlled remotely). Contrarily to a popular belief, a server is not necessarily a huge and extra-powerful machine : nowadays, a small, ~$30 ARM board is adequate for self-hosting. -Problems can happen and the server could become unavailable: a power outage, Internet access loss, etc. +Self-hosting is not about making "your Internet" more secure or does not provide anonymity by itself. Instead, it is about being autonomous, and in control of your services and data - which also means being responsible for them. -If you use the [email system](email_en) and your server becomes unavailable, emails destined to the server will be re-sent under 3 to 7 days. +Why should you host yourself ? +------------------------------ -#### Self-hosting contraints -* Slow transfer speed. With ADSL, upload is approximately 1/10 of the rate of download. For instance: 1 Mb/s download speed would give an upload speed of 100 kb/s; -* Availability must be 24/7; -* Move; +- **You believe in a free, open and decentralized internet.** In a centralized internet, private companies and governement can spy, analyze and influence people by dictating how they connect with each other, and by filtering content. Yunohost is developed by a community who believe in an open and decentralized internet, and we hope that you do, too ! -#### Self-hosting issues -* Anonymity, private life; -* Reappropriation of personnal data and services; -* Decentralization, distributed networks; +- **You want to have control on your data and services.** Your pictures, chat messages, browsing history, and that text you are writing for school, have nothing to do on somebody else's server (a.k.a. The Cloud). They are part of your private life, but also part of your family's life, your friend's life, and so on. These data should be managed by *you*, not a random company in the US who wants your data to analyze them and sell the results. - +- **You want to learn about how computers and the Internet work.** Operating your own server is a pretty good context to understand the basic mechanisms at the heart of operating systems and the Internet. You might have to deal with command line interface, network architecture, DNS configuration, SSH, and so on. -#### Others Self-hosting projects -##### Under active development -- [Cloudron](https://cloudron.io) -- [Cozy](https://cozy.io) -- [FreedomBox](https://wiki.debian.org/FreedomBox) -- [Libre.sh](https://github.com/indiehosters/libre.sh) -- [Puffin](http://puffin.rocks) -- [Sandstorm](https://sandstorm.io/) -- [Sovereign](https://github.com/al3x/sovereign) -- [UBOS](http://ubos.net) +- **You want to explore new possibilities and customize things.** Ever dreamed of running a Minecraft server for you friends, or a persistent IRC or XMPP client ? With you very own server, you can manually install and run virtually any program you want, and customize every bits. -##### Unmaintained -- [ArkOS](http://web.archive.org/web/20170603213149/https://arkos.io/) -- [Host@home](http://web.archive.org/web/20160206150730/http://yeuxdelibad.net/Programmation/Hostathome.html) +Why should you *not* host yourself ? +------------------------------------ +- **Self-hosting requires some work and patience.** Hosting yourself is a bit like growing your own garden or vegetables : it requires work and patience. While YunoHost aims to do all the hard work for you, self-hosting still requires that you take time to learn and configure a few things to setup your server properly. You will also need to perform maintenance tasks (such as upgrades) from time to time, or to ask for support if some things break. + +- **With great servers comes great responsabilities.** Operating a server means that you are responsible of the data you are hosting. Nobody will be able to recover them for you if they get lost. YunoHost provides backup features, which you should use regularly to backup the configurations and data you care about. You should also keep and eye on security news and recommentations so that your server or critical data don't get compromised. + +- **Quality and performance probably won't be as good as premium services.** YunoHost (and most of the applications packaged for it) are free and open-source softwares, developped by communities of people in their free time and on the basis of best effort. There is no absolute guarantee that software will work in every possible circumstances. The performance of your self-hosted server is also related to its CPU and RAM, and to the available internet connectivity. -#### Learn more -* [Decentralized Web Summit](http://www.decentralizedweb.net/) -* [Feudal Security](https://www.schneier.com/blog/archives/2012/12/feudal_sec.html) Bruce Schneier, famous security expert exposes the risks of a centralized web and the importance of civic action. diff --git a/selfhosting_fr.md b/selfhosting_fr.md index 1d3af99b..c83acfe3 100644 --- a/selfhosting_fr.md +++ b/selfhosting_fr.md @@ -1,47 +1,28 @@ -# L’auto-hébergement +L'auto-hébergement +================== -#### Définition -L’**auto-hébergement** consiste à héberger chez soi son serveur, ses données et ses services. +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 personelles 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. -#### Responsabilités de l’administrateur -Si vous souhaitez vous servir d’un site web, du [courrier électronique](/email_fr) et de la [messagerie instantanée](/XMPP_fr), le serveur devra rester allumé tout le temps, soit 24h/24 et 7j/7. +L'auto-hébergement implique de disposer d'un serveur. Un serveur est un ordinateur qui est destiné à être accessible sur le réseau en permanence, et n'a généralement pas d'écran ni de clavier puisqu'il est administé à distance. Contrairement à une croyance répandue, les serveurs ne sont pas nécessairement des machines énormes et extrèmement puissante : aujourd'hui, une petite carte ARM à ~30€ est adéquate pour de l'auto-hébergement. -L’auto-hébergement entraîne une disponibilité du serveur envers les utilisateurs hébergés sur votre serveur et/ou aux personnes extérieures consultants le serveur. +Pratique l'auto-hébergement ne rends pas "votre internet" plus sécurisé et ne fourni pas d'anonymat en tant que tel. L'objectif est généralement de pouvoir être autonome et au contrôle de ses services et de ses données - ce qui implique aussi d'en être responsable. -Il peut y avoir des problèmes rendant le serveur indisponible : une coupure électrique, une perte d’accès à Internet…etc. +Pourquoi s'auto-héberger ? +-------------------------- -Si vous vous servez du système de [courrier électronique](/email_fr), et que votre serveur est indisponible, les mails destinés au serveur seront de nouveau envoyés sous 3 à 7 jours. +- **Vous croyez en un internet libre, ouvert et décentralisé.** Dans un internet centralisé, les entités privées et les gouvernement peuvent espionner, analyser et influencer les personnes en dictant la façon dont elle peuvent interagir les unes avec les autres, ainsi qu'en filtrant du contenu. Yunohost est développé par une communauté qui croit en un internet ouvert et décentralisé. Nous espérons que vous aussi ! -#### Contraintes de l’auto-hébergement -* Le débit d’émission est faible. Dans le cas de l’ADSL, il est souvent de l’ordre de 1/10 par rapport au débit de réception. Par exemple : 1 Mo/s de réception et 100 ko/s d’émission ; -* La disponibilité 24/7 ; -* Le déménagement ; +- **Vous voulez avoir le contrôle de vos données et services.** Vos images, votre messages de chat, votre historique de navigation, et votre dissertation pour l'école n'ont rien à faire sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud). Ces données font parties de votre vie privée, mais également de celle de votre famille, de vos amis, etc. Ces données devraient être gérées par *vous*, et non par une quelconque entreprise américaine qui cherche à analyser vos données pour revendre les résultats. -#### Enjeux de l’auto-hébergement -* Anonymat, vie privée ; -* Réappropriation de ces données de ces services ; -* Décentralisation, réseaux distribués ; +- **Vous souhaitez apprendre comment fonctionnent les ordinateurs et Internet.** Opérer son propre serveur est un bon contexte pour apprendre les mécanismes de base au coeur des systèmes d'exploitations (OS) et d'Internet. Il vous faudra possiblement toucher à la ligne de commande et à des morceaux de configuration réseau et DNS. - +- **Vous voulez explorer de nouvelles possibilités et personnaliser votre espace.** Avez-vous déjà rêvé d'avoir votre propre serveur Minecraft pour vos ami.e.s, ou un client IRC ou XMPP persistent ? Avec votre propre serveur, vous pouvez manuellement installer et faire tourner n'importe quel program et personnaliser chaque morceau. -#### Autres projets d’auto-hébergement -##### En développement -- [Cloudron](https://cloudron.io) -- [Cozy](https://cozy.io) -- [FreedomBox](https://wiki.debian.org/FreedomBox) -- [Libre.sh](https://github.com/indiehosters/libre.sh) -- [Puffin](http://puffin.rocks) -- [Sandstorm](https://sandstorm.io/) -- [Sovereign](https://github.com/al3x/sovereign) -- [UBOS](http://ubos.net) +Pourquoi ne *pas* s'auto-héberger ? +----------------------------------- -##### Non maintenu -- [ArkOS](http://web.archive.org/web/20170603213149/https://arkos.io/) -- [Host@home](http://web.archive.org/web/20160206150730/http://yeuxdelibad.net/Programmation/Hostathome.html) +- **L'auto-hébergement requiert du travail et de la patience.** S'auto-héberger est un peu comme avoir son propre jardin ou potager : cela demande du travail et de la patience. Bien que YunoHost cherche à faire tout le travail compliqué pour vous, il vous faudra tout de même premdre le temps d'apprendre et configurer quelques détails pour que votre installation marche correctement. Il vous faudra aussi gérer quelques taches de maintenance (telles que les mises à jour) de temps en temps, et demander de l'aide si des choses ne fonctionnent pas comme prévu. +- **Avec de grands serveur viennent les grandes responsabilités.** Opérer un serveur implique d'être responsable des données que vous hébergez : personne ne pourra récupérer des données à votre place si vous les perdez. YunoHost fourni des fonctionnalités de sauvegarder qu'il est recommandé d'utiliser pour sauvegarder les configurations et données importantes. Il vous faut aussi garder un oeil sur les recommandations et les nouvelles à propos de la sécurité pour que votre serveur ou vos données ne soient pas compromises. -#### Pour aller plus loin -* [Auto-hebergement.fr](http://www.auto-hebergement.fr/) -* [Conférence de Benjamin Bayart - Internet libre, ou Minitel 2.0 ?](http://www.fdn.fr/internet-libre-ou-minitel-2.html) -* [Conférence de Dufromentel - Auto-hébergement vous pouvez ? - Capitole du Libre - 2014](http://videos2014.capitoledulibre.org/internet-libre/dufromentel-auto-hebergement-vous-pouvez.webm) -* [Conférence de Richard Stallman - Le logiciel libre](http://perso.telecom-paristech.fr/~boucart/video/conf_stallman.webm) +- **La qualité et les performances ne seront probablement pas aussi bonne que des services premium.** YunoHost (et la plupart des applications qui sont packagées) sont des logiciels libres et open-source, développés par des communautés bénévoles. Il n'y a pas de garantie absolue que ces logiciels marcheront dans toutes les circonstances possibles. Les performances de votre serveur auto-hébergé sont aussi liés au processeur, à la mémoire vive et à la connectivité internet. diff --git a/users.md b/users.md new file mode 100644 index 00000000..1d7ea512 --- /dev/null +++ b/users.md @@ -0,0 +1,40 @@ +Users and the SSO +================= + +Users +----- + +Users are human being who have access to applications and other services on your server. The administrator can add and manage users through the web administration (in the User category) or through the command line (see `yunohost user --help`). After that, users obtain a personal email address (chosen by the admin), an XMPP account, and can log in the user portal to access applications they have permissions over and configure other parameters. + +The first user created also automatically gets email aliases `root@main.domain.tld` and `admin@main.domain.tld`, such that mail sent to these adresses will end up in the first user's mailbox. + +
+You should be careful about who you give your server access to. In terms of security, this largely increase the attack surface for someone who wants to mess with the server one way or another. +
+ +The user portal, or SSO +----------------------- + +
+ +The user portal, also called the SSO for 'Single Sign On' allows user to browse easily between the different apps they have access to. In particular, the term 'Single Sign On' comes from the fact that user only need to log in the portal to automatically be logged to all apps that require authentication (or at least those who are integrated with the SSO/LDAP, since this is sometimes technically complicated or not possible at all). + +In the portal, users can also click on the avatar in the top-left to configure some other settings such as their identify, mail aliases, automatic mail forwards, or change their password. + +
+You should be aware that the SSO can only be reached through the actual domain name (i.e. `https://the.domain.tld/yunohost/sso`), and NOT by just using the IP of the server (i.e. `https://11.22.33.44/yunohost/sso`), contrarily to the webadmin ! This is a bit confusing but is necessary for technical reason. If you are in a situation where you need to access the SSO without having your DNS properly configured for some reason, you might consider tweaking your `/etc/hosts` as described in [this page](dns_local_nework). +
+ +App permissions +--------------- + +Access to apps can be restricted to some users only. This can be configured via the webadmin in Applications > (choose an app) > Access, or similarly via the command line `yunohost app addaccess`, `removeaccess` and `clearaccess`. + +SSH access +---------- + +Users can also be allowed to connect through SSH, and SSH keys can be added for this purpose. So far, this can only be configured via the command line. See `yunohost user ssh --help` for specific commands. + +
+Be careful who you give SSH access to. This increases even more the attack surface available to a malicious user. +
diff --git a/users_fr.md b/users_fr.md new file mode 100644 index 00000000..274e29fc --- /dev/null +++ b/users_fr.md @@ -0,0 +1,41 @@ +Les utilisateurs et le SSO +========================== + +Utilisateurs +----- + +Les utilisateurs sont les êtres humains qui ont accès aux applications et autres services sur votre serveur. L'administrateur peut ajouter et gérer des utilisateurs via l'administration web (dans la catégorie Utilisateurs) ou via la catégorie `yunohost user` de la ligne de commande. Après cela, les utilisateurs obtiennent une adresse e-mail personnelle (choisie par l'administrateur), un compte XMPP, et peuvent se connecter au portail utilisateur pour accéder aux applications pour lesquelles ils ont des permissions et configurer d'autres paramètres. + +Le premier utilisateur créé reçoit aussi automatiquement les alias email `root@main.domain.tld` et `admin@main.domain.tld`, de sorte que le courrier envoyé à ces adresses se retrouvera dans la boîte aux lettres de cet utilisateur. + +
+Vous devriez faire attention à qui vous donnez l'accès à votre serveur. En termes de sécurité, cela augmente considérablement la surface d'attaque pour quelqu'un qui veut perturber le serveur d'une manière ou d'une autre. +
+ +Le portail utilisateur, ou SSO +----------------------- + +
+ +Le portail utilisateur, également appelé SSO pour 'Single Sign On', permet à l'utilisateur de naviguer facilement entre les différentes applications auxquelles il a accès. En particulier, le terme 'Single Sign On' vient du fait que l'utilisateur n'a qu'à se connecter au portail pour être automatiquement connecté à toutes les applications qui nécessitent une authentification (ou du moins celles qui sont intégrées avec le SSO/LDAP, car cela est parfois techniquement compliqué ou pas possible du tout). + +Dans le portail, les utilisateurs peuvent également cliquer sur l'avatar en haut à gauche pour configurer d'autres paramètres tels que leur identité, les alias de messagerie, les transferts automatiques de courrier ou changer leur mot de passe. + +
+Vous devez être conscient que le SSO ne peut être atteint que par le nom de domaine (i.e. `https://the.domain.tld/yunohost/sso`), et non pas en utilisant l'IP du serveur (i.e. `https://11.22.33.44/yunohost/sso`), contrairement à l'administrateur web ! C'est un peu déroutant dans certaine situation, mais est nécessaire pour des raisons techniques. Si vous êtes dans une situation où vous avez besoin d'accéder au SSO sans avoir votre DNS correctement configuré pour une raison quelconque, vous pouvez envisager de modifier votre `/etc/hosts' comme décrit dans [cette page](dns_local_nework). +
+ +Permissions d'accès aux applications +--------------- + +L'accès aux applications peut être limité à certains utilisateurs seulement. Ceci peut être configuré via la webadmin dans Applications > (une application) > Accès, ou de la même manière via la ligne de commande `yunohost app addaccess`, `removeaccess` et `clearaccess`. + +Accès SSH +---------- + +Les utilisateurs peuvent également être autorisés à se connecter via SSH, et des clés SSH peuvent être ajoutées à cette fin. Jusqu'à présent, ceci ne peut être configuré que via la ligne de commande. Voir `yunohost user ssh --help` pour des commandes spécifiques. + +
+Faites attention à qui vous donnez accès à SSH. Cela augmente encore plus la surface d'attaque disponible pour un utilisateur malveillant. +
+ diff --git a/whatsyunohost.md b/whatsyunohost.md index c8242f55..a83e3f83 100644 --- a/whatsyunohost.md +++ b/whatsyunohost.md @@ -1,71 +1,30 @@ -#What is YunoHost? - -YunoHost is a **server operating system** aiming to make [self-hosting](selfhosting) accessible to everyone. It is based on [Debian GNU/Linux](https://debian.org) and is fully compatible with it. - - ---- - -### Features - -- multi-user with LDAP integration -- multi-domains -- an email system -- an instant messaging server -- a Single sign-on (SSO) -- an application system -- a backup system -- a regen configuration services system +What is YunoHost? +================= ---- +Goal +---- -### Software +YunoHost is a **server operating system** aiming to make [self-hosting](selfhosting) accessible to as many people as possible, without taking away from the quality and reliability of the software. YunoHost supports [several kind of hardware](install). It is based on [Debian GNU/Linux](https://debian.org) and is fully compatible with it. -Basically YunoHost **automatically installs** and configures some services around LDAP, and **provides tools** to administrate them. +Features +-------- -It can thus be considered as a distribution, including the following software: +- based on Debian ; +- administrate your server through a **friendly web admin** ; +- easily **install applications** on your server ; +- manage **users** (based on LDAP); +- manage **domains** ; +- create and restore **backups** ; +- users can be logged in all apps through the **Single Sign-On** (SSO) system (SSOwat) ; +- includes a **full email stack** (Postfix, Dovecot, Rspamd, DKIM) ; +- ... as well as **an instant messaging server** (XMPP) ; +- ... a **SSL certificate** management system (interfaced with Let's Encrypt) ; +- and **security systems** (fail2ban, yunohost-firewall) ; - - - - - - - - -* [Nginx](http://nginx.org/): a Web server -* [Postfix](http://www.postfix.org/): an SMTP e-mail server -* [Dovecot](http://www.dovecot.org/): an IMAP and a POP3 e-mail server -* [Rspamd](https://rspamd.com/): an e-mail spam filtering -* [Metronome](https://metronome.im/): an XMPP server -* [OpenLDAP](http://www.openldap.org/): an LDAP server -* [Dnsmasq](http://www.thekelleys.org.uk/dnsmasq/doc.html): a DNS server -* [SSOwat](https://github.com/Kloadut/SSOwat): a Single Sign On (SSO) web authentication system -- [Let's Encrypt](https://letsencrypt.org): a certificate manager - ---- - -### App system - -Additionally, YunoHost comes with an **app** system which is, in other words, **a community repository** of validated helper scripts to install further services or web applications. - -The most interesting thing about this system is that **web applications benefits from the LDAP** through the SSO (Single Sign On), which authenticate server's users in every installed apps at the same time. - -You may be interessed in reading the [packaging documentation](/packaging_apps) and the [SSOwat GitHub page](https://github.com/Kloadut/SSOwat) to go further. - - - - - - - - - - ---- - -### Origin +Origin +------ YunoHost was created in February 2012 after something like this: @@ -76,24 +35,14 @@ All that was needed was an administration interface for Beudbeud's server to mak 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, more extensible, more powerful, more easy-to-use, and one that makes a nice cup of fair-trade coffee for the elves of Lapland. ---- - -### Goal - -YunoHost's goal is to make installing and administering a server accessible to as many people as possible, without taking away from the quality and reliability of the software. - -Everything is done with the goal of simplifying deployment on as many different kinds of hardware as possible, and in any condition (at home, on a dedicated server or on a VPS). - ---- - -### Name +Name +---- **YunoHost** comes from the jargon "Y U NO Host". The [Internet meme](https://en.wikipedia.org/wiki/Internet_meme) should illustrate it:
---- - -### Development +Development +----------- YunoHost is developed to be as **simple** and minimally-intrusive as possible, to retain compatibility with Debian. It merely proposes a package of automatic configurations for existing software, and is configurable via simple interfaces. @@ -101,16 +50,14 @@ YunoHost is **entirely** a free software project. The philosophy of self-hosting Do not hesitate to visit the ["contribute" page](/contribute). ---- - -### Security +Security +-------- All the efforts have been made to keep YunoHost secure, and **communications encrypted**. You can read more about this subject on the related page: [https://yunohost.org/security](/security) ---- - -### What YunoHost is not? +What YunoHost is not? +--------------------- Even if YunoHost can handle multiple domains and multiple users, it is **not meant to be a mutualized system**. @@ -118,15 +65,14 @@ First, the software is too young, not tested at large scale and thus probably no You can host your friends, your family and your company safely and with ease, but you have to **trust your users**, and they have to trust you above all. If you do want to provide YunoHost services for unknown persons anyway, a full VPS per user will be just fine, and we believe is a better way to go. ---- - -### Art Works +Art Works +--------- Black and white YunoHost png logo done by ToZz (400 × 400 px): - + - + Click to download. diff --git a/whatsyunohost_ar.md b/whatsyunohost_ar.md index f32b896b..f6634cb6 100644 --- a/whatsyunohost_ar.md +++ b/whatsyunohost_ar.md @@ -26,58 +26,6 @@ --- -###
البرمجيات
-
-عمليًا، يقوم واي يونوهوست YunoHost **بالتنصيب و الإعداد الآلي** لبعض الخدمات التي تشتغل حول نظام LDAP، و كذا **بتوفير الأدوات اللازمة** لإدارتها. - -لذا يمكن اعتباره كتوزيعة بحد ذاتها تضم كل مِن البرمجيات التالية : -
- - - - - - - - - -
-* [Nginx](http://nginx.org/) : خادم صفحات الويب -* [Postfix](http://www.postfix.org/) : خادم للبريد الإلكتروني الصادر عبر بروتوكول SMTP -* [Dovecot](http://www.dovecot.org/) : خادم للبريد الإلكتروني عبر بروتوكولي IMAP و POP3 -* [Rspamd](https://rspamd.com/) : مُضاد للبريد المُزعج -* [Metronome](http://www.lightwitch.org/metronome) : خادم للمحادثة الفورية عبر بروتوكول XMPP -* [OpenLDAP](http://www.openldap.org/) : un système d’annuaire -* [Dnsmasq](http://www.thekelleys.org.uk/dnsmasq/doc.html) : خادم أسماء النطاقات دي آن أس DNS -* [SSOwat](https://github.com/Kloadut/SSOwat) : (SSO) نظام للمصادقة عبر الويب -- [Let's Encrypt](https://letsencrypt.org): مدير للشهادات الإلكترونية الآمنة -
- ---- - -###
نظام للتطبيقات
-
- -بالإضافة إلى ما سبق، يُوَفِّرُ YunoHost نظامًا "للتطبيقات" على شكل **مُستودَع مُجتمعاتيّ** من السكريبتات التي تساعد المستخدِم على تثبيت خدمات و تطبيقات ويب إضافية. - -La chose la plus intéressante avec ce système est que **les applications web profitent de la base LDAP** via le SSO (Single Sign On), qui authentifie les utilisateurs du serveur avec un unique nom d’utilisateur/mot de passe. -
-
- -قد تهمكم قراءة صفحة [الدليل حول التحزيم](/packaging_apps_fr) وصفحة جيت هب الخاصة بـ[SSOwat](https://github.com/YunoHost/SSOwat/) لمعرفة المزيد. -
- - - - - - - - - - ---- - ###
أصل فكرة المشروع
@@ -136,4 +84,4 @@ Même si YunoHost est multi-domaine et multi-utilisateur, il reste **inappropri Premièrement parce que le logiciel est trop jeune, donc non-testé et non-optimisé pour être mis en production pour des centaines d’utilisateurs en même temps. Et quand bien même, ce n’est pas le chemin que l’on souhaite faire suivre à YunoHost. La virtualisation se démocratise, et c’est une façon bien plus étanche et sécurisée de faire de la mutualisation. Vous pouvez héberger vos amis, votre famille ou votre entreprise sans problème, mais vous devez **avoir confiance** en vos utilisateurs, et ils doivent de la même façon avoir confiance en vous. Si vous souhaitez tout de même fournir des services YunoHost à des inconnus, **un VPS entier par utilisateur** sera la meilleure solution. -
\ No newline at end of file +
diff --git a/whatsyunohost_fr.md b/whatsyunohost_fr.md index 52b474ec..3cccd8a1 100644 --- a/whatsyunohost_fr.md +++ b/whatsyunohost_fr.md @@ -1,73 +1,30 @@ -#Qu’est-ce que YunoHost ? - -YunoHost est un **système d’exploitation serveur** visant à simplifier l’auto-hébergement de services Internet. -Il est basé et reste totalement compatible avec [Debian GNU/Linux](https://debian.org). - - - ---- - -### Fonctionnalités - -- multi-utilisateurs avec intégration LDAP -- multi-domaines -- un système d’emails -- un serveur de messagerie instantanée -- un système d’authentification unique (SSO) -- un système d’applications -- un système de backup -- un système de régénération de configuration des services +Qu'est-ce que YunoHost ? +======================== ---- +Objectif +-------- -### Logiciels +YunoHost est un **système d’exploitation serveur** visant à rendre accessible [l’auto-hébergement](selfhosting_fr) à autant de personne que possible, sans délaisser la qualité et la fiabilité du logiciel. YunoHost supporte [plusieurs types de matériel](install_fr) et est basé et compatible avec [Debian GNU/Linux](https://debian.org). -Concrètement, YunoHost **installe et configure automatiquement** quelques services autour de LDAP, et **fournit des outils** pour les administrer. +Fonctionnalités +--------------- -On peut donc le considérer comme une distribution, comprenant les logiciels suivants : +- basé sur Debian ; +- administration via une **gentille interface web** ; +- **deployez facilement des applications** ; +- gérez des **utilisateurs** (gérés via LDAP) ; +- gérez des **domaines** ; +- créez et restaurez des **sauvegardes** ; +- les utilisateurs peuvent se connecter à toutes les apps à travers le système de **Single Sign-On** (SSO) (SSOwat) ; +- viens avec un **serveur mail complet** (Postfix, Dovecot, Rspamd, DKIM) ; +- ... ainsi qu'un **serveur de messagerie instantannée** (XMPP) ; +- ... un système de gestion de **certificats SSL** (interfacé avec Let's Encrypt) ; +- et des **systèmes de sécurité** (fail2ban, yunohost-firewall) ; - - - - - - - - -* [Nginx](http://nginx.org/) : un serveur web -* [Postfix](http://www.postfix.org/) : un serveur de messagerie électronique SMTP -* [Dovecot](http://www.dovecot.org/) : un serveur de messagerie électronique IMAP et POP3 -* [Rspamd](https://rspamd.com/) : un antispam -* [Metronome](http://www.lightwitch.org/metronome) : un serveur XMPP -* [OpenLDAP](http://www.openldap.org/) : un système d’annuaire -* [Dnsmasq](http://www.thekelleys.org.uk/dnsmasq/doc.html) : un serveur de DNS -* [SSOwat](https://github.com/Kloadut/SSOwat) : un (SSO) système d’authentification web -- [Let's Encrypt](https://letsencrypt.org): un gestionnaire de certificats - ---- - -### Système d’app - -En complément, YunoHost fournit un système d’« app » qui n’est autre qu’un **dépôt communautaire** de scripts aidant à installer des services et applications web supplémentaires. - -La chose la plus intéressante avec ce système est que **les applications web profitent de la base LDAP** via le SSO (Single Sign On), qui authentifie les utilisateurs du serveur avec un unique nom d’utilisateur/mot de passe. - -Vous serez peut-être intéressé à la lecture de la [documentation sur le packaging](/packaging_apps_fr) et la page GitHub d’[SSOwat](https://github.com/YunoHost/SSOwat/) pour aller plus loin. - - - - - - - - - - ---- - -### Origine +Origine +------- YunoHost est un projet né en février 2012 à la suite d’à peu près ça : @@ -78,24 +35,21 @@ Il ne manquait en fait qu’une interface d’administration au serveur de Beudb Constatant l’engouement croissant autour de YunoHost et de l’auto-hébergement en général, les développeurs et les nouveaux contributeurs ont alors décidé de prendre le cap d’une version 2, plus accessible, plus extensible, plus puissante, et qui prépare du bon café commerce équitable pour les lutins de Laponie. +But --- -### But - Le but de YunoHost est de rendre accessibles au plus grand nombre l’installation et l’administration d’un serveur, sans délaisser la qualité et la fiabilité du logiciel. Tous les efforts sont faits pour simplifier le déploiement sur le plus d’appareils possible et dans toutes les conditions (chez soi, sur son serveur dédié ou sur un VPS). +Nom --- -### Nom - **YunoHost** vient de l’argot Internet anglais « Y U NO Host » signifiant approximativement « Pourquoi toi ne pas héberger ». Le [mème Internet](http://fr.wikipedia.org/wiki/M%C3%A8me_Internet) qui l’illustre est à peu près celui-ci :
---- - -### Développement +Développement +------------- YunoHost est développé pour être le plus **simple** et le moins intrusif possible pour garder la compatibilité avec Debian. Il propose uniquement un ensemble de configurations automatiques et opère via des interfaces accessibles. @@ -103,15 +57,13 @@ Le tout est bien entendu **entièrement libre**. La philosophie de l’[auto-hé N’hésitez pas à visiter la page « [contribuez](/contribute_fr) ». ---- - -### Sécurité +Sécurité +-------- Tous les efforts ont été déployés pour sécuriser YunoHost, et **chiffrer tous les protocoles**. Une explication plus détaillée est disponible [ici](/security_fr). ---- - -### Qu’est-ce que YunoHost n’est pas ? +Qu’est-ce que YunoHost n’est pas ? +---------------------------------- Même si YunoHost est multi-domaine et multi-utilisateur, il reste **inapproprié pour un usage mutualisé**. @@ -119,15 +71,14 @@ Premièrement parce que le logiciel est trop jeune, donc non-testé et non-optim Vous pouvez héberger vos amis, votre famille ou votre entreprise sans problème, mais vous devez **avoir confiance** en vos utilisateurs, et ils doivent de la même façon avoir confiance en vous. Si vous souhaitez tout de même fournir des services YunoHost à des inconnus, **un VPS entier par utilisateur** sera la meilleure solution. ---- - -# Logo +Logo +---- Logo Yunohost noir et blanc réalisé par ToZz (400 × 400 px) : - + - + Cliquer pour télécharger.