mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
spaces and caps
This commit is contained in:
ericgaspar
parent
9cb02ee855
commit
5f59c993b4
51 changed files with 101 additions and 126 deletions
2
OVH.md
2
OVH.md
|
|
@ -1,4 +1,4 @@
|
|||
#DNS Configuration with OVH
|
||||
# DNS Configuration with OVH
|
||||
|
||||
Let's see how to properly set the DNS redirections with [OVH](http://www.ovh.com).
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Configuration DNS avec OVH
|
||||
# Configuration DNS avec OVH
|
||||
|
||||
Nous allons voir comment configurer le DNS avec [OVH](http://www.ovh.com).
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Chat, VoIP et réseau social avec <img src="/images/XMPP_logo.png" width=100>
|
||||
# Chat, VoIP et réseau social avec <img src="/images/XMPP_logo.png" width=100>
|
||||
|
||||
YunoHost est installé par défaut avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (anciennement connu sous le nom Jabber).
|
||||
|
||||
|
|
|
|||
|
|
@ -46,7 +46,7 @@
|
|||
* [Orange](/isp_orange)
|
||||
* [Free](/isp_free)
|
||||
* [Documentation spécifique à certaines apps](/appsdoc)
|
||||
* [Equivalence entre service Framasoft et apps](/apps_framasoft)
|
||||
* [Équivalence entre service Framasoft et apps](/apps_framasoft)
|
||||
* [Échanger des fichiers avec son serveur à l'aide d'une interface graphique](/filezilla)
|
||||
* [Modifier l'apparence du portail utilisateur](/theming)
|
||||
* [Ajouter un stockage externe](/external_storage)
|
||||
|
|
|
|||
2
apps.md
2
apps.md
|
|
@ -1,7 +1,7 @@
|
|||
# Application catalog
|
||||
|
||||
<span class="javascriptDisclaimer">
|
||||
This page requires Javascript enabled to display properly :s.
|
||||
This page requires JavaScript enabled to display properly :s.
|
||||
<br/>
|
||||
<br/>
|
||||
</span>
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# Catalogue d'applications
|
||||
# Catalogue d’applications
|
||||
|
||||
<span class="javascriptDisclaimer">
|
||||
Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
|
||||
Cette page requiert que JavaScript soit activé pour s'afficher correctement :s.
|
||||
<br/>
|
||||
<br/>
|
||||
</span>
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Blacklist forms
|
||||
# Blacklist forms
|
||||
|
||||
It could happen sometimes that your IP is blacklisted by some email provider, or anti-spam services.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Flasher l'ISO YunoHost
|
||||
# Flasher l’ISO YunoHost
|
||||
|
||||
Maintenant que vous avez téléchargé l’image ISO de YunoHost, vous devez la mettre sur un support physique. Classiquement, il s'agit d'une **Clé USB** ou d'une **Carte SD**.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,10 +1,10 @@
|
|||
#New page
|
||||
# New page
|
||||
|
||||
This page is not created yet, you can edit it by pressing ```<ESC>``` on your keyboard or by clicking the "edit" button on the bottom-right side of your screen. You will be able to preview your changes by pressing ```<ESC>``` again or by clicking the "preview" button.
|
||||
|
||||
** Note: ** You will need to provide an email address to validate your submission.
|
||||
|
||||
###Syntax
|
||||
### Syntax
|
||||
|
||||
This page use the markdown syntax, please refer to the documentation for further informations:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Nueva página
|
||||
# Nueva página
|
||||
|
||||
Esta página todavía no existe, puedes editarla tecleando ```<Escap>``` en tu teclado, o clicando en el botón "Editar" abajo a la derecha de tu pantalla. Puedes echar un vistazo a los cambios que has efectuado empujando de nuevo la tecla ```<Escap>``` o clicando en el botón "Vistazo".
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Nouvelle page
|
||||
# Nouvelle page
|
||||
|
||||
Cette page n’existe pas encore, vous pouvez l’éditer en appuyant sur la touche ```<Échap>``` de votre clavier, ou en cliquant sur le bouton "Éditer" en bas à droite de votre écran. Vous pourrez avoir un aperçu de vos changements en appuyant à nouveau sur la touche ```<Échap>``` ou en cliquant sur le bouton "Aperçu".
|
||||
|
||||
|
|
|
|||
|
|
@ -1,10 +1,10 @@
|
|||
#Nuova Pagina
|
||||
# Nuova Pagina
|
||||
|
||||
Questa pagina non è ancora stata creata, puoi modificarla premendo ```<ESC>``` sulla tua tastiera o cliccando il pulsante "Modifica" in basso a destra del tuo schermo. Potrai vedere l'anteprima delle tue modifiche premendo ancora ```<ESC>``` o cliccando il pulsante "Anteprima".
|
||||
|
||||
** Nota: ** Devi fornire un indirizzo email per confermare le tue modifiche.
|
||||
|
||||
###Sintassi
|
||||
### Sintassi
|
||||
|
||||
Questa pagina usa la sintassi markdown, per favore fai riferimento alla documentazione per ulteriori informazioni:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Local network access to your server
|
||||
# Local network access to your server
|
||||
|
||||
After completing your server installation, it is most likely that your domain will not be accessible through the local network. This is a know issue known as [hairpinning](http://en.wikipedia.org/wiki/Hairpinning).
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Acceder a tu servidor desde la red local
|
||||
# Acceder a tu servidor desde la red local
|
||||
|
||||
Después de haber instalado tu servidor, es probable que tu nombre de dominio no esté accesible desde la red local donde se encuentra el servidor. Esto es un problema que se llama el [hairpinning](https://en.wikipedia.org/wiki/Hairpinning).
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Accéder à son serveur depuis le réseau local
|
||||
# Accéder à son serveur depuis le réseau local
|
||||
|
||||
Après installation de votre serveur, il est probable que votre nom de domaine ne soit pas accessible depuis le réseau local où se trouve le serveur. Ceci est un problème connu sous le nom de [hairpinning](http://fr.wikipedia.org/wiki/Hairpinning).
|
||||
|
||||
|
|
|
|||
2
docs.md
2
docs.md
|
|
@ -1,4 +1,4 @@
|
|||
#Documentation
|
||||
# Documentation
|
||||
|
||||
<p class="lead">
|
||||
YunoHost's documentation has 2 different sections:
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Documentation
|
||||
# Documentation
|
||||
|
||||
<p class="lead">
|
||||
Die YunoHost Dokumentation ist in 2 Bereiche aufgeteilt:
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Documentation
|
||||
# Documentation
|
||||
|
||||
<p class="lead">
|
||||
La documentation de YunoHost s’articule autour de deux sections :
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Documentazione
|
||||
# Documentazione
|
||||
|
||||
<p class="lead">
|
||||
La documentazione di YunoHost ha 2 differenti sezioni:
|
||||
|
|
|
|||
15
domains.md
15
domains.md
|
|
@ -1,5 +1,4 @@
|
|||
Domains, DNS conf and certificate
|
||||
=================================
|
||||
# Domains, DNS conf and certificate
|
||||
|
||||
YunoHost allows you to manage and serve several domains on the same server. For instance, you can host a blog and 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 handle web services, mail services and XMPP services.
|
||||
|
||||
|
|
@ -9,25 +8,21 @@ The domain chosen during the postinstall is defined as the main domain of the se
|
|||
|
||||
Finally, take note that, in the context of YunoHost, there is no hierarchy between the domains it knows. In the previous example, you may add a third domain `foo.yolo.com` - but it would be considered as a domain independent of `yolo.com`.
|
||||
|
||||
Non-latin characters
|
||||
-----------------
|
||||
## Non-latin characters
|
||||
|
||||
If your domain has special, non-latin characters, you need to use its [internationalized version](https://en.wikipedia.org/wiki/Internationalized_domain_name) through [Punycode](https://en.wikipedia.org/wiki/Punycode). You can use [this converter](https://www.charset.org/punycode), and use the converted domain name in your YunoHost configuration.
|
||||
|
||||
DNS configuration
|
||||
-----------------
|
||||
## DNS configuration
|
||||
|
||||
DNS (Domain Name System) is a system that allows computers from around the world to translate human-readable domain names (such as `yolo.com`) to machine-understandable adresses called IP addresses (such as `11.22.33.44`). For this translation (and other features) to work, you 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
|
||||
----------------------
|
||||
## SSL/HTTPS certificates
|
||||
|
||||
Another important aspect of domain configuration is the SSL/HTTPS certificate. YunoHost is integrated with Let's Encrypt, so once your server is correctly reachable from anybody on the internet through the domain name, the administrator can request a Let's Encrypt certificate. See the documentation about [certificates](certificate) for more information.
|
||||
|
||||
Subpaths vs. individual domains per apps
|
||||
----------------------------------------
|
||||
## 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", so that you end up with something like this:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,5 +1,4 @@
|
|||
Domaines, configuration DNS et certificats
|
||||
==========================================
|
||||
# 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.
|
||||
|
||||
|
|
@ -9,25 +8,21 @@ Le domaine choisi lors de la postinstall est défini comme le domaine principal
|
|||
|
||||
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`.
|
||||
|
||||
Caractères non latins
|
||||
-----------------
|
||||
## Caractères non latins
|
||||
|
||||
Si votre domain contient des caractères spéciaux, non latins, vous devez utiliser sa [version internationalisée](https://fr.wikipedia.org/wiki/Nom_de_domaine_internationalis%C3%A9) en [Punycode](https://fr.wikipedia.org/wiki/Punycode). Vous pouvez utiliser [ce convertisseur](https://www.charset.org/punycode), et utiliser le nom de domaine converti dans YunoHost.
|
||||
|
||||
Configuration DNS
|
||||
-----------------
|
||||
## 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
|
||||
----------------------
|
||||
## 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](/certificate) pour plus d'informations.
|
||||
|
||||
Sous-chemins vs. domaines individuels par application
|
||||
-----------------------------------------------------
|
||||
## 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 :
|
||||
|
||||
|
|
|
|||
18
email.md
18
email.md
|
|
@ -1,12 +1,10 @@
|
|||
Emails
|
||||
======
|
||||
# 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
|
||||
-------------------------------
|
||||
## Making sure your setup is right
|
||||
|
||||
Email is a complicated ecosystem and quite a few details can prevent it from working properly.
|
||||
|
||||
|
|
@ -18,22 +16,19 @@ To validate your setup:
|
|||
|
||||
A score of at least 8~9/10 is a reasonnable goal.
|
||||
|
||||
Email clients
|
||||
-------------
|
||||
## 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 server - 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 device, allowing offline viewing and relative protection against possible hardware failures of your server.
|
||||
|
||||
Configuring email aliases and auto-forwards
|
||||
-------------------------------------------
|
||||
## 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 an email sent to this adress will end in the inbox of the first user. Automatic forwards may be configured, for instance if an user doesn't want to configure an additional email account and just wants 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@the.domain.tld` will automatically land in the `booking` dir (lowercase) of John Doe's mailbox or in John Doe's inbox if `booking` directory doesn't exist . 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 ?
|
||||
-----------------------------------------------
|
||||
## 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 email, until it drops it if it was unable to send it.
|
||||
|
||||
|
|
@ -42,7 +37,6 @@ It is possible that the sent emails from your YunoHost instance are considered a
|
|||
Is it possible that the IP address from your server have been previously been used to sent spam or that these email services consider your server as a spam sender.
|
||||
To ensure that your servers’ IP address isn’t into this blacklists and to remove it from them, follow this [link](/blacklist_forms).
|
||||
|
||||
Migrating email from an email provider to a YunoHost instance
|
||||
-------------------------------------------------------------
|
||||
## Migrating email from an email provider to a YunoHost instance
|
||||
|
||||
See [this page](email_migration).
|
||||
|
|
|
|||
|
|
@ -1,12 +1,12 @@
|
|||
## Configurer un client mail
|
||||
## Configurer un client email
|
||||
|
||||
Vous pouvez récupérer et envoyer des emails avec votre instance YunoHost grâce à des logiciels comme Mozilla Thunderbird, ou sur votre smartphone grâce à des applications comme K-9 Mail.
|
||||
|
||||
Normalement, votre client mail devrait recevoir la configuration automatiquement lorsque vous ajoutez un compte. Si cela ne fonctionne pas, il est possible de le faire manuellement en suivant les quelques étapes suivantes. (Cependant, cela devrait être compris comme étant un bug dans YunoHost, et le cas échéant, c'est cool si vous nous notifiez du problème pour que nous puissions tenter de reproduire et corriger le problème !)
|
||||
Normalement, votre client email devrait recevoir la configuration automatiquement lorsque vous ajoutez un compte. Si cela ne fonctionne pas, il est possible de le faire manuellement en suivant les quelques étapes suivantes. (Cependant, cela devrait être compris comme étant un bug dans YunoHost, et le cas échéant, c'est cool si vous nous notifiez du problème pour que nous puissions tenter de reproduire et corriger le problème !)
|
||||
|
||||
### Réglages génériques
|
||||
|
||||
Voici les éléments que vous devrez entrer pour configurer manuellement votre client mail (`domain.tld` fait référence à ce qui est après le @ dans votre adresse mail, et `nom_dutilisateur` ce qui est avant @).
|
||||
Voici les éléments que vous devrez entrer pour configurer manuellement votre client email (`domain.tld` fait référence à ce qui est après le @ dans votre adresse email, et `nom_dutilisateur` ce qui est avant @).
|
||||
|
||||
| Protocole | Port | Chiffrement | Authentification | Login |
|
||||
| :--: | :-: | :--: | :--: | :--: |
|
||||
|
|
@ -35,7 +35,7 @@ Suivez les instructions suivantes. (Comme pour Thunderbird, il vous faudra peut-
|
|||
|
||||
La première fois, vous pouvez simplement choisir "Ajouter un compte". Si vous avez déjà un compte configuré, appuyez sur le menu hamburger puis sur le rouage, choisissez Courrier, Comptes et appuyez sur le symbole " + ".
|
||||
|
||||
Sélectionnez ensuite IMAP. Remplissez les champs et appuyez sur Suivant. Dekko va ensuite chercher la configuration. Vérifiez que tous les champs sont corrects. Assurez-vous d'avoir votre nom d'utilisateur yunohost, PAS votre adresse e-mail et choisissez "Autoriser les certificats non fiables". Faites ceci pour IMAP et SMTP et appuyez sur Suivant. Dekko va ensuite synchroniser le compte après quoi vous aurez terminé. Félicitations !
|
||||
Sélectionnez ensuite IMAP. Remplissez les champs et appuyez sur Suivant. Dekko va ensuite chercher la configuration. Vérifiez que tous les champs sont corrects. Assurez-vous d'avoir votre nom d'utilisateur yunohost, PAS votre adresse email et choisissez "Autoriser les certificats non fiables". Faites ceci pour IMAP et SMTP et appuyez sur Suivant. Dekko va ensuite synchroniser le compte après quoi vous aurez terminé. Félicitations !
|
||||
|
||||
<a href="/images/dekko_config_1.png"><img src="/images/dekko_config_1.png" width=200/></a>
|
||||
<a href="/images/dekko_config_2.png"><img src="/images/dekko_config_2.png" width=200/></a>
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Migrer ses emails d'un ancien serveur mail vers YunoHost
|
||||
# Migrer ses emails d’un ancien serveur mail vers YunoHost
|
||||
|
||||
*[Documentation en rapport avec l’email de YunoHost](/email)*.
|
||||
|
||||
|
|
|
|||
7
faq.md
7
faq.md
|
|
@ -1,6 +1,5 @@
|
|||
# Frequently Asked Questions
|
||||
|
||||
|
||||
#### Under which license is YunoHost distributed?
|
||||
|
||||
YunoHost packages are under free licenses GNU AGPL v.3.
|
||||
|
|
@ -28,10 +27,10 @@ YunoHost may be called a distribution or an operating system, but it's actually
|
|||
"just" a simple layer added over the top of Debian, which does most of the hard
|
||||
work for you.
|
||||
|
||||
For instance, if you wanted to install Wordpress, you would need to type a bunch
|
||||
For instance, if you wanted to install WordPress, you would need to type a bunch
|
||||
of commands to create some users, setup a web server, setup a SQL server,
|
||||
download the Wordpress archive, uncompress it, configure the web server,
|
||||
configure the SQL database, and finally configure Wordpress. YunoHost handles
|
||||
download the WordPress archive, uncompress it, configure the web server,
|
||||
configure the SQL database, and finally configure WordPress. YunoHost handles
|
||||
the technical details and "types all these commands for you", so that you can focus
|
||||
on what really matters.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# Exchange files with your server using a graphical interface
|
||||
|
||||
This page explains how to exchange files (backup archives, music, pictures,
|
||||
movies, ...) with your server using a graphical interface for the (S)FTP protocol.
|
||||
movies...) with your server using a graphical interface for the (S)FTP protocol.
|
||||
This is an alternative to using `scp` which can be deemed technical and cryptic,
|
||||
or using an app like Nextcloud.
|
||||
|
||||
|
|
@ -80,6 +80,6 @@ Nautilus from Gnome3 has features similar to FileZilla, out of the box.
|
|||
|
||||
* [WinSCP](https://winscp.net/) is also a nice candidate for Windows
|
||||
|
||||
### MacOS
|
||||
### macOS
|
||||
|
||||
* [Cyberduck](https://cyberduck.io/) is a free software available on MacOS
|
||||
* [Cyberduck](https://cyberduck.io/) is a free software available on macOS
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# Échanger des fichiers avec son serveur à l'aide d'une interface graphique
|
||||
# Échanger des fichiers avec son serveur à l’aide d’une interface graphique
|
||||
|
||||
Cette page explique comment échanger des fichiers (sauvegardes, musiques,
|
||||
photos, films, ...) avec son serveur à l'aide d'un outil graphique. C'est donc
|
||||
photos, films...) avec son serveur à l'aide d'un outil graphique. C'est donc
|
||||
une méthode alternative au fait d'utiliser la commande `scp` qui peut être jugée
|
||||
technique et cryptique, ou de devoir installer Nextcloud.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,15 +1,13 @@
|
|||
User groups and permissions
|
||||
===========================
|
||||
# User groups and permissions
|
||||
|
||||
You can access the *groups and permissions* management interface from the webadmin
|
||||
by going into the 'Users' section and clicking the corresponding button:
|
||||
|
||||
|
||||
|
||||
Managing groups
|
||||
---------------
|
||||
## Managing groups
|
||||
|
||||
The group mechanism can be used to define groups of users which then can be used to restrict permissions for applications and other services (such as mail or xmpp). Note that it is *not* mandatory to create a group to do so: you can also restrict access to an app or service on a user-per-user basis.
|
||||
The group mechanism can be used to define groups of users which then can be used to restrict permissions for applications and other services (such as mail or XMPP). Note that it is *not* mandatory to create a group to do so: you can also restrict access to an app or service on a user-per-user basis.
|
||||
|
||||
Using groups is however useful for semantics, for example if you host multiple groups of friends, associations or businesses on your server, you might want to create groups like `association1` and `association2` and add members of each association to the relevant group.
|
||||
|
||||
|
|
@ -71,7 +69,7 @@ $ yunohost user group update yolo_crew --add charlie delphine
|
|||
|
||||
(similarly, `--remove` can be used to remove members from a group)
|
||||
|
||||
Now in the group list we should see :
|
||||
Now in the group list we should see:
|
||||
|
||||
```shell
|
||||
$ yunohost user group list
|
||||
|
|
@ -100,10 +98,9 @@ To delete the group `yolo_crew` in CLI, you may run
|
|||
$ yunohost user group delete yolo_crew
|
||||
```
|
||||
|
||||
Managing permissions
|
||||
--------------------
|
||||
## Managing permissions
|
||||
|
||||
The permission mechanism allow to restrict access to services (for example mail, xmpp, ...) and apps, or even specific parts of the apps (for example the administration interface of wordpress).
|
||||
The permission mechanism allow to restrict access to services (for example mail, XMPP...) and apps, or even specific parts of the apps (for example the administration interface of WordPress).
|
||||
|
||||
### List permissions
|
||||
|
||||
|
|
@ -126,7 +123,7 @@ permissions:
|
|||
allowed: all_users
|
||||
```
|
||||
|
||||
Here, we find that all registered users can use email, xmpp, and access the wordpress blog. However, nobody can access the wordpress admin interface.
|
||||
Here, we find that all registered users can use email, XMPP, and access the WordPress blog. However, nobody can access the WordPress admin interface.
|
||||
|
||||
More details can be displayed by adding the `--full` option which will display the list of users corresponding to groups allowed, as well as urls associated to a permission (relevant for web apps).
|
||||
|
||||
|
|
@ -136,7 +133,7 @@ To add a permission to a group, simply click the "+" button in the group panel,
|
|||
|
||||
|
||||
|
||||
To allow a group to access the wordpress admin interface in CLI:
|
||||
To allow a group to access the WordPress admin interface in CLI:
|
||||
|
||||
```shell
|
||||
$ yunohost user permission update wordpress.admin --add yolo_crew
|
||||
|
|
@ -152,7 +149,7 @@ or in CLI:
|
|||
$ yunohost user permission update wordpress.admin --add alice
|
||||
```
|
||||
|
||||
And now we may see that both the YoloCrew and Alice have access to the wordpress admin interface :
|
||||
And now we may see that both the YoloCrew and Alice have access to the WordPress admin interface:
|
||||
|
||||
```shell
|
||||
$ yunohost user permission list
|
||||
|
|
@ -164,7 +161,7 @@ $ yunohost user permission list
|
|||
[...]
|
||||
```
|
||||
|
||||
Note that, for example, if we want to restrict permission for email so that only Bob is allowed to email, we should also remove `all_users` from the permission, by deleting it from the `all_users` group panel, or in CLI :
|
||||
Note that, for example, if we want to restrict permission for email so that only Bob is allowed to email, we should also remove `all_users` from the permission, by deleting it from the `all_users` group panel, or in CLI:
|
||||
|
||||
```shell
|
||||
$ yunohost user permission update mail --remove all_users --add bob
|
||||
|
|
@ -174,8 +171,7 @@ The webadmin will issue a warning if you set a permission that is superseeded by
|
|||
|
||||
|
||||
|
||||
Notes for apps packagers
|
||||
------------------------
|
||||
## Notes for apps packagers
|
||||
|
||||
Installing an app creates the permission `app.main` with `all_users` allowed by default.
|
||||
|
||||
|
|
@ -228,7 +224,7 @@ If you still need to use regex to protect or unprotect urls, you can't use the n
|
|||
|
||||
But you can create a fake permission and use hooks to handle if there is a change in this faked permission.
|
||||
|
||||
In the install script, create the fake permission (with no url):
|
||||
In the install script, create the fake permission (with no URL):
|
||||
|
||||
`ynh_permission_create --permission="create poll" --allowed "visitors" "all_users"`
|
||||
|
||||
|
|
|
|||
|
|
@ -1,14 +1,13 @@
|
|||
Groupes et permissions
|
||||
===========================
|
||||
# Groupes et permissions
|
||||
|
||||
Vous pouvez accéder à l'interface de gestion des *groupes et des permissions* depuis la webadmin
|
||||
en allant dans la section "Utilisateurs" et en cliquant sur le bouton correspondant :
|
||||
|
||||
|
||||
|
||||
Gestion des groupes
|
||||
---------------
|
||||
Le mécanisme de groupe peut être utilisé pour définir des groupes d'utilisateurs qui peuvent ensuite être utilisés pour restreindre les autorisations pour les applications et autres services (tels que l'email ou xmpp). Notez qu'il n'est *pas* obligatoire de créer un groupe pour ce faire : vous pouvez également restreindre l'accès à une application ou à un service de manière individuelle.
|
||||
## Gestion des groupes
|
||||
|
||||
Le mécanisme de groupe peut être utilisé pour définir des groupes d'utilisateurs qui peuvent ensuite être utilisés pour restreindre les autorisations pour les applications et autres services (tels que l'email ou XMPP). Notez qu'il n'est *pas* obligatoire de créer un groupe pour ce faire : vous pouvez également restreindre l'accès à une application ou à un service de manière individuelle.
|
||||
|
||||
L'utilisation de groupes est cependant utile pour la sémantique, par exemple si vous hébergez plusieurs groupes d'amis, des associations ou des entreprises sur votre serveur, vous pouvez créer des groupes comme "association1" et "association2" et ajouter les membres de chaque association au groupe concerné.
|
||||
|
||||
|
|
@ -96,10 +95,9 @@ Pour supprimer le groupe `yolo_crew` dans CLI, vous pouvez exécuter
|
|||
$ yunohost user group delete yolo_crew
|
||||
```
|
||||
|
||||
Gestion des permissions
|
||||
--------------------
|
||||
## Gestion des permissions
|
||||
|
||||
Le mécanisme de permissions permet de restreindre l'accès aux services (par exemple mail, xmpp, ...) et aux applications, ou même à des parties spécifiques des applications (par exemple l'interface d'administration de wordpress).
|
||||
Le mécanisme de permissions permet de restreindre l'accès aux services (par exemple mail, XMPP...) et aux applications, ou même à des parties spécifiques des applications (par exemple l'interface d'administration de WordPress).
|
||||
|
||||
### Liste des permissions
|
||||
|
||||
|
|
@ -120,7 +118,7 @@ permissions:
|
|||
xmpp.main:
|
||||
allowed: all_users
|
||||
```
|
||||
Ici, nous constatons que tous les utilisateurs enregistrés peuvent utiliser le courrier électronique, xmpp, et accéder au blog wordpress. Cependant, personne ne peut accéder à l'interface d'administration de wordpress.
|
||||
Ici, nous constatons que tous les utilisateurs enregistrés peuvent utiliser le courrier électronique, XMPP, et accéder au blog WordPress. Cependant, personne ne peut accéder à l'interface d'administration de WordPress.
|
||||
|
||||
Plus de détails peuvent être affichés en ajoutant l'option `--full` qui affichera la liste des utilisateurs correspondant aux groupes autorisés, ainsi que les urls associées à une permission (pertinent pour les applications web).
|
||||
|
||||
|
|
@ -130,7 +128,7 @@ Pour ajouter une permission à un groupe, il suffit de cliquer sur le bouton "+"
|
|||
|
||||
|
||||
|
||||
Pour permettre à un groupe d'accéder à l'interface d'administration de wordpress via la CLI :
|
||||
Pour permettre à un groupe d'accéder à l'interface d'administration de WordPress via la CLI :
|
||||
|
||||
```shell
|
||||
$ yunohost user permission update wordpress.admin --add yolo_crew
|
||||
|
|
@ -146,7 +144,7 @@ ou en CLI :
|
|||
$ yunohost user permission update wordpress.admin --add alice
|
||||
```
|
||||
|
||||
Et maintenant, nous pouvons voir que YoloCrew et Alice ont tous deux accès à l'interface d'administration de Wordpress :
|
||||
Et maintenant, nous pouvons voir que YoloCrew et Alice ont tous deux accès à l'interface d'administration de WordPress :
|
||||
|
||||
```shell
|
||||
$ yunohost user permission list
|
||||
|
|
@ -171,8 +169,7 @@ La webadmin émettra un avertissement si vous définissez une permission qui est
|
|||
|
||||
|
||||
|
||||
Notes aux packageurs d'applications
|
||||
------------------------
|
||||
## Notes aux packageurs d'applications
|
||||
|
||||
L'installation d'une application crée l'autorisation `app.main` avec `all_users` autorisée par défaut.
|
||||
|
||||
|
|
@ -249,7 +246,7 @@ fi
|
|||
|
||||
Dans cet exemple, si l'application est publique, le groupe `visitors` a accès à l'autorisation `create poll`, sinon le groupe est supprimé de cette autorisation.
|
||||
|
||||
Créez ensuite deux fichiers dans le répertoire `hooks` à la racine du dépôt git de l'application : `post_app_addaccess` et `post_app_removeaccess`. Dans ces hooks, vous supprimerez ou rajouterez la protection contre les regex si le groupe `visitors` est ajouté ou supprimé de cette autorisation :
|
||||
Créez ensuite deux fichiers dans le répertoire `hooks` à la racine du dépôt Git de l'application : `post_app_addaccess` et `post_app_removeaccess`. Dans ces hooks, vous supprimerez ou rajouterez la protection contre les regex si le groupe `visitors` est ajouté ou supprimé de cette autorisation :
|
||||
|
||||
`post_app_addaccess`
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Besoin d'aide ?
|
||||
# Besoin d’aide ?
|
||||
|
||||
<h3>Connectez-vous au salon de support</h3>
|
||||
<center>
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# How to host yourself ?
|
||||
# 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:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Choisir son mode d'autohébergement
|
||||
# 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 :
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Instalar Yunohost en una tarjeta ARM
|
||||
# Instalar YunoHost en una tarjeta ARM
|
||||
|
||||
*Encontrar otros medios de instalar YunoHost **[aquí](/install)**.*
|
||||
|
||||
|
|
|
|||
|
|
@ -17,5 +17,3 @@
|
|||
<a class="btn btn-lg btn-default" href="/install_manually">1. Install manually</a>
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/postinstall">2. Proceed with the initial configuration (post-installation)</a>
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Configuration de l'IPv6
|
||||
# Configuration de l’IPv6
|
||||
|
||||
L'IPv6 peut fonctionner directement dans certains cas. Mais dans d'autres, ou chez certains hébergeurs spécifiques, vous devez activer l'IPv6 manuellement.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,5 @@
|
|||
# Orange
|
||||
|
||||
*Find the list of other Internet service providers **[here](/isp)**.*
|
||||
|
||||
#### Email
|
||||
|
|
|
|||
|
|
@ -1,4 +1,5 @@
|
|||
# Orange
|
||||
|
||||
*Trouvez la liste d’autres fournisseurs d’accès Internet **[ici](/isp)**.*
|
||||
|
||||
#### Le courrier électronique
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#SFR
|
||||
# SFR
|
||||
*Trouvez la liste d’autres fournisseurs d’accès Internet **[ici](/isp)**.*
|
||||
#### Accès à l’administration de la box
|
||||
* Allez à cette adresse : http://192.168.1.1.
|
||||
|
|
|
|||
|
|
@ -10,9 +10,9 @@ This page is dedicated to help you migrating an instance from YunoHost 2.7.x (ru
|
|||
|
||||
- Yet, please don't rush into thinking that you should rush into reinstalling your system. A common "mistake" is to be willing to reinstall a server at the slightest complication. But turns out that reinstalling a system can also be complicated. Instead, if you happen to run into issues, we encourage you to try to investigate and understand what's going on and reach for help instead of just throwing away everything because it looks simpler.
|
||||
|
||||
- About external email clients : if you or your users are using external email clients (typically Thunderbird, K9Mail, ...) be aware that the SMTP port changed from 465 (with SSL/TLS) to 587 (STARTTLS). See [this page of doc dedicated to email clients](/email_configure_client). Webmail configurations such as Rainloop should also be updated using the corresponding administration interface.
|
||||
- About external email clients: if you or your users are using external email clients (typically Thunderbird, K9Mail...) be aware that the SMTP port changed from 465 (with SSL/TLS) to 587 (STARTTLS). See [this page of doc dedicated to email clients](/email_configure_client). Webmail configurations such as Rainloop should also be updated using the corresponding administration interface.
|
||||
|
||||
- For advanced users : if you have some custom scripts for backups, be aware that we made some backward-incompatible changes in the backup command line. The deprecated `--hooks`/`--ignore-hooks` options were removed, as well as the options `--ignore-apps`, `--ignore-system`. To make things more intuitive, `yunohost backup create --apps wordpress` (for example) will only backup wordpress, i.e. you don't have to add `--ignore-system` to not backup the system.
|
||||
- For advanced users: if you have some custom scripts for backups, be aware that we made some backward-incompatible changes in the backup command line. The deprecated `--hooks`/`--ignore-hooks` options were removed, as well as the options `--ignore-apps`, `--ignore-system`. To make things more intuitive, `yunohost backup create --apps wordpress` (for example) will only backup wordpress, i.e. you don't have to add `--ignore-system` to not backup the system.
|
||||
|
||||
## Migration procedure
|
||||
|
||||
|
|
@ -22,7 +22,7 @@ After upgrading to 2.7.14, go to Tools > Migrations to access the migrations int
|
|||
|
||||
#### From the command line
|
||||
|
||||
After upgrading to 2.7.14, run :
|
||||
After upgrading to 2.7.14, run:
|
||||
|
||||
```bash
|
||||
sudo yunohost tools migrations migrate
|
||||
|
|
@ -34,7 +34,7 @@ then read carefully and accept the disclaimer.
|
|||
|
||||
Depending on your hardware and packages installed, the migration might take up to a few hours.
|
||||
|
||||
Note that it is expected to see some errors (in particular about fail2ban) during the migration, so don't worry too much about them.
|
||||
Note that it is expected to see some errors (in particular about Fail2Ban) during the migration, so don't worry too much about them.
|
||||
|
||||
#### If the migration crashed / failed at some point.
|
||||
|
||||
|
|
@ -46,9 +46,9 @@ If the migration failed at some point, it should be possible to relaunch it. If
|
|||
|
||||
You should be able to see this from the webadmin Tools > Diagnosis, and also in the footer of the page. On the command line, you can use `lsb_release -a` and `yunohost --version`.
|
||||
|
||||
#### Check that fail2ban and the firewall are active
|
||||
#### Check that Fail2Ban and the firewall are active
|
||||
|
||||
You should be able to see that fail2ban and the firewall are active. From the webadmin in Services (look for 'fail2ban' and 'yunohost-firewall'). From the command line, run `yunohost service status fail2ban yunohost-firewall`. They should both have `active: active`.
|
||||
You should be able to see that Fail2Ban and the firewall are active. From the webadmin in Services (look for 'fail2ban' and 'yunohost-firewall'). From the command line, run `yunohost service status fail2ban yunohost-firewall`. They should both have `active: active`.
|
||||
|
||||
#### Check that your applications are working
|
||||
|
||||
|
|
|
|||
|
|
@ -34,7 +34,7 @@ puis lisez attentivement l'avertissement et les instructions.
|
|||
|
||||
En fonction de votre matériel et des paquets installés, la migration peut prendre jusqu'à quelques heures.
|
||||
|
||||
Notez qu'il est attendu de voir certaines erreurs (en particulier à propos de fail2ban) pendant la migration - ne vous en inquiétez pas trop.
|
||||
Notez qu'il est attendu de voir certaines erreurs (en particulier à propos de Fail2Ban) pendant la migration - ne vous en inquiétez pas trop.
|
||||
|
||||
#### Si la migration a crashé / échoué à un moment.
|
||||
|
||||
|
|
@ -46,9 +46,9 @@ Si la migration a échoué a un moment donné, la première chose à faire est d
|
|||
|
||||
Pour cela, allez dans Outils > Diagnostique. (Vous pouvez aussi regarder ce qui est affiché dans le pied de page). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`.
|
||||
|
||||
#### Vérifiez que fail2ban et le pare-feu sont actifs.
|
||||
#### Vérifiez que Fail2Ban et le pare-feu sont actifs.
|
||||
|
||||
Vous devriez voir que fail2ban et le firewall sont actifs. Depuis la webadmin, dans Services (chercher 'fail2ban' et 'yunohost-firewall'). Depuis la ligne de commande, faites `yunohost service status fail2ban yunohost-firewall` : les deux devraient être en `active: active`.
|
||||
Vous devriez voir que Fail2Ban et le firewall sont actifs. Depuis la webadmin, dans Services (chercher 'fail2ban' et 'yunohost-firewall'). Depuis la ligne de commande, faites `yunohost service status fail2ban yunohost-firewall` : les deux devraient être en `active: active`.
|
||||
|
||||
#### Vérifiez que les applications fonctionnent
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Déplacer un dossier d'application vers un autre espace de stockage
|
||||
# Déplacer un dossier d’application vers un autre espace de stockage
|
||||
|
||||
Les dossiers d'application se trouvent (*habituellement*) dans `/var/www/$nom_application`
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Récupérer l'accès à son YunoHost
|
||||
# Récupérer l’accès à son YunoHost
|
||||
|
||||
Il existe de nombreuses causes pouvant empêcher totalement ou partiellement d'accéder en administrateur à un serveur YunoHost. Dans de nombreux cas, un des moyens d'accès est inaccessible, mais les autres sont fonctionnels.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,5 +1,4 @@
|
|||
Overview of the YunoHost ecosystem
|
||||
==================================
|
||||
# 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.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,5 +1,4 @@
|
|||
Vue d'ensemble de l'écosystème YunoHost
|
||||
=======================================
|
||||
# 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.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,5 @@
|
|||
# NGINX configuration
|
||||
|
||||
This tutorial aim to help setup NGINX configuration for application packaging.
|
||||
|
||||
#### NGINX configuration
|
||||
|
|
|
|||
|
|
@ -1,4 +1,5 @@
|
|||
# Configuration NGINX
|
||||
|
||||
Ce tutoriel a pour but d’aider à la mise en place d’une configuration NGINX pour le packaging d’application.
|
||||
|
||||
#### Configuration NGINX
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
#Registar
|
||||
# Registar
|
||||
|
||||
Here is a list of Registrars to book domain names:
|
||||
* [OVH](http://ovh.com/)
|
||||
|
|
|
|||
|
|
@ -1,4 +1,3 @@
|
|||
|
||||
# Sécurité
|
||||
|
||||
YunoHost a été développé dans l’optique de fournir une sécurité maximale tout en restant accessible et facilement installable.
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# L'auto-hébergement
|
||||
# L’auto-hébergement
|
||||
|
||||
L'auto-hébergement est le fait d'avoir et d'administrer son propre serveur, typiquement chez soi, pour héberger soi-même ses données personnelles et des services plutôt que de se reposer exclusivement sur des tiers. Par exemple, il est possible d'auto-héberger son blog de sorte qu'il "vive" dans une machine que vous contrôlez, au lieu qu'il soit sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud) en échange d'argent, de publicités ou de données privées.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Personnaliser l'apparence du portail utilisateur
|
||||
# Personnaliser l’apparence du portail utilisateur
|
||||
|
||||
## Utiliser un thème
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# Qu'est-ce que YunoHost ?
|
||||
# Qu’est-ce que YunoHost ?
|
||||
|
||||
<img src="/images/YunoHost_logo_vertical.png" width=400>
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue