Merge branch 'master' into featureCipherCompatibility

This commit is contained in:
Romuald du Song 2019-03-03 18:02:13 +01:00
commit f97330bcd7
132 changed files with 2183 additions and 2069 deletions

View file

@ -20,7 +20,7 @@ There are several web client built with social network features :
You can also use a desktop client such as :
- [Pidgin](http://pidgin.im/) (multiplatform),
- [Gajim](http://gajim.org/) (Linux),
- [Gajim](http://gajim.org/) (Linux, Windows),
- [Dino](https://dino.im) (Linux),
- [Thunderbird](https://www.thundebird.net/) (multiplatform),
- [Jitsi](http://jitsi.org/) (multiplatform)

View file

@ -10,7 +10,7 @@ Toutes les applications basées sur XMPP sont compatibles entre-elles : lorsque
Un compte XMPP/Jabber est basé sur un identifiant sous la forme `utilisateur@domaine.tld`, ainsi quun mot de passe.
Sous yunohost, cet identifiant correspond simplement à ladresse courriel principale dun utilisateur. Le mot de passe est celui du compte de lutilisateur.
Sous Yunohost, cet identifiant correspond simplement à ladresse courriel principale dun utilisateur. Le mot de passe est celui du compte de lutilisateur.
### Se connecter à XMPP
@ -20,7 +20,7 @@ Il existe des clients web orientés réseau social, comme :
Vous pouvez également utiliser un client desktop comme
- [Pidgin](http://pidgin.im/) (multiplateforme),
- [Gajim](http://gajim.org/index.fr.html) (Linux),
- [Gajim](http://gajim.org/index.fr.html) (Linux, Windows),
- [Dino](https://dino.im) (Linux),
- [Thunderbird](https://www.mozilla.org/fr/thunderbird/) (multiplateforme),
- [Jitsi](http://jitsi.org/) (multiplateforme)

55
admin_api.md Normal file
View file

@ -0,0 +1,55 @@
# Administration from the API or an external application
All command line actions can also be ran from the web API. The API is available at https://your.server/yunohost/api. For now there's no documentation on the various routes ... but you can get an idea by looking at the actionmap [here](https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/actionsmap/yunohost.yml) (in particular the `api` stuff).
## Using `curl`
You must first retrieve a login cookie to perform the actions. Here is an example via curl:
```bash
# Login (with admin password)
curl -k -H "X-Requested-With: customscript" \
-d "password=supersecretpassword" \
-dump-header headers \
https://your.server/yunohost/api/login
# GET example
curl -k -i -H "Accept: application/json" \
-H "Content-Type: application/json" \
-L -b headers -X GET https://your.server/yunohost/api/ROUTE \
| grep } | python -mjson.tool
```
## Using a PHP class
To simplify the remote administration of a YunoHost instance in CHATONS/Librehosters projects, API classes have been developed by users.
For example, this [PHP class](https://github.com/scith/yunohost-api-php) will allow you to administer your YunoHost instance from a PHP application (website, capacity management tool...).
Here is an example of PHP code to add a user to your YunoHost instance:
```php
require("ynh_api.class.php");
$ynh = new YNH_API("adresse IP du serveur YunoHost ou nom dhôte", "mot de passe administrateur");
if ($ynh->login()) {
$domains = $ynh->get("/domains");
$first_domain = $domains['domains'][0];
$arguments = array(
'username' => 'test',
'password' => 'yunohost',
'firstname' => 'Prénom',
'lastname' => 'Nom',
'mail' => 'test@'.$first_domain,
'mailbox_quota' => '500M'
);
$user_add = $ynh->post("/users", $arguments);
print_r($user_add);
} else {
print("Login to YunoHost failed.\n");
exit;
}
```

View file

@ -1,21 +1,36 @@
# Administration depuis lAPI ou une application externe
Toutes les actions exécutables en ligne de commande le sont également via une API.
Toutes les actions exécutables en ligne de commande le sont également via une API. LAPI est accessible à ladresse https://votre.serveur/yunohost/api.
Pour le moment, il n'existe pas de documentation des différentes routes ... mais
vous pouvez trouver l'actionmap [ici](https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/actionsmap/yunohost.yml) (en particulier les clefs `api`)
LAPI utilise ladresse https://VOTRESERVEUR/yunohost/api et toutes les actions sont détaillées sur cette page.
## Avec `curl`
Il faut dabord récupérer un cookie de connexion pour ensuite réaliser les actions. Voici un exemple via curl :
```bash
Login (avec mot de passe admin): curl -k -d “password=XXX” dump-header headers https://VOTRESERVEUR/yunohost/api/login
GET: curl -k -i -H “Accept: application/json” -H “Content-Type: application/json” -L -b headers -X GET https://VOTRESERVEUR/yunohost/api/ROUTE | grep }| python -mjson.tool
```
Pour simplifier ladministration à distance dune instance YunoHost dans le cadre dun projet CHATONS, des classes API ont été développées par des utilisateurs.
Par exemple, cette classe PHP vous permettra dadministrer votre instance YunoHost depuis une application PHP (site web, outil de gestion de capacité…).
```bash
# Login (avec mot de passe admin)
curl -k -H "X-Requested-With: customscript" \
-d "password=supersecretpassword" \
-dump-header headers \
https://your.server/yunohost/api/login
# Example de GET
curl -k -i -H "Accept: application/json" \
-H "Content-Type: application/json" \
-L -b headers -X GET https://your.server/yunohost/api/ROUTE \
| grep } | python -mjson.tool
```
# Avec une classe PHP
Pour simplifier ladministration à distance dune instance YunoHost dans le cadre dun projet CHATONS/Librehosters, des classes API ont été développées par des utilisateurs.
Par exemple, cette [classe PHP](https://github.com/scith/yunohost-api-php) vous permettra dadministrer votre instance YunoHost depuis une application PHP (site web, outil de gestion de capacité…).
Voici un exemple de code PHP permettant dajouter un utilisateur dans votre instance YunoHost :
```bash
```php
require("ynh_api.class.php");
$ynh = new YNH_API("adresse IP du serveur YunoHost ou nom dhôte", "mot de passe administrateur");
@ -40,3 +55,4 @@ if ($ynh->login()) {
exit;
}
```

View file

@ -34,6 +34,8 @@
* [Updating the system](/update) and [apps](/app_update)
* [Security](/security)
* Going further
* [Noho.st / nohost.me / ynh.fr domain names](/dns_nohost_me)
* [Exchange files with your server using a graphical interface](/filezilla)
* [Adding an external storage](/external_storage)
* [Migrating emails to YunoHost](/email_migration)
* [Hide services with Tor](/torhiddenservice)

View file

@ -21,18 +21,18 @@
* [Installer un certificat SSL](/certificate_fr)
* [Diagnostic du bon fonctionnement du YunoHost](/diagnostic_fr)
* Apprendre à connaitre YunoHost
* [Vue d'ensemble de YunoHost](/overview)
* [Conseil généraux](/guidelines)
* [L'interface d'administration web](/admin)
* [SSH](/ssh) et [l'administration en ligne de commande](/commandline)
* [Les utilisateurs et le SSO](/users)
* [Les 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)
* [Vue d'ensemble de YunoHost](/overview_fr)
* [Conseil généraux](/guidelines_fr)
* [L'interface d'administration web](/admin_fr)
* [SSH](/ssh_fr) et [l'administration en ligne de commande](/commandline_fr)
* [Les utilisateurs et le SSO](/users_fr)
* [Les applications](/apps_overview_fr)
* [Les domaines, la configuration DNS et les certificats](/domains_fr)
* [Les emails](/email_fr)
* [XMPP](/XMPP_fr)
* [Les sauvegardes](/backup_fr)
* [Mettre à jour le système](/update_fr) et [les applications](/app_update_fr)
* [La sécurité](/security_fr)
* Pour aller plus loin
* Noms de domaine
* [Nom de domaine en noho.st / nohost.me / ynh.fr](/dns_nohost_me_fr)
@ -44,6 +44,7 @@
* [SFR](/isp_sfr_fr)
* [Orange](/isp_orange_fr)
* [Free](/isp_free_fr)
* [Échanger des fichiers avec son serveur à l'aide d'une interface graphique](/filezilla)
* [Ajouter un stockage externe](/external_storage_fr)
* [Migrer ses emails vers YunoHost](/email_migration_fr)
* [YunoHost avec un service caché Tor](/torhiddenservice_fr)

13
app_dokuwiki.md Normal file
View file

@ -0,0 +1,13 @@
DokuWiki
========
Homepage: https://dokuwiki.org
DokuWiki is a wiki application licensed under GPLv2 and written in the PHP programming language. It works on plain text files and thus does not need a database. Its syntax is similar to the one used by MediaWiki.More at Wikipedia
Developer(s):Andreas Gohr, et al.
Operating system:Cross-platform
Platform:PHP
License:GNU General Public License

4
app_hextris_fr.md Normal file
View file

@ -0,0 +1,4 @@
#Hextris
Car parfois il faut savoir se détendre. Hébergez votre propre fork du célèbre Tetris et devenez le maitre de cet hexagone infernal.
Qui domptera cet hexagone infernal ?

15
app_mediawiki.md Normal file
View file

@ -0,0 +1,15 @@
# Mediawiki
![Mediawiki](images/Mediawiki_logo.png)
MediaWiki is a free and open source software wiki package written in PHP, originally for use on Wikipedia.
## Overview
![Mediawiki_screenshot](images/Mediawiki_screenshot.png)
## Link
Mediawiki : https://www.mediawiki.org/
FAQ : https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ
Support Desk : https://www.mediawiki.org/wiki/Project:Support_desk

15
app_mediawiki_fr.md Normal file
View file

@ -0,0 +1,15 @@
# Mediawiki
![Mediawiki](images/Mediawiki_logo.png)
MediaWiki est un ensemble wiki à base de logiciels libres Open source, développé à lorigine pour Wikipédia.
## Aperçu
![Mediawiki_screenshot](images/Mediawiki_screenshot.png)
## Liens
Mediawiki : https://www.mediawiki.org/
FAQ : https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ
Support Desk : https://www.mediawiki.org/wiki/Project:Support_desk

20
app_my_webapp.md Normal file
View file

@ -0,0 +1,20 @@
# Documentation My_webapp
In addition to the application's Readme.md, here are some useful tips.
## Automatic update of the site content
The application creates a new user with limited rights: it can connect (with a password) through SFTP to access the `/var/www/my_webapp` directory (or `/var/www/my_webapp__<number>` if there are several installations of this application).
This configuration requires updating the site content manually, with a password connection.
If you want to automate things, you need to be able to connect without typing a password (i.e. "non-interactive"). Here are the steps to follow to get there:
- Enable public key connection, in `/etc/ssh/ssh/sshd_config`, on the server
- Create a public/private key pair for your script on the "writing" computer - without a protective passphrase.
- Copy the public key to the server, in `/var/www/my_webapp(__#)/.ssh/authorized_keys`
- Set the user `webapp#` as owner of the file and directory
- You can now connect without a password, with `sftp -b`, `lftp` or other SFTP clients.
NB: The port number to use for the SFTP connection is the one used for the SSH, and configured in `/etc/ssh/sshd_config`.
This tip allows you to automatically update your site. For example, the makefile of the Pelican tool allows you to use `make ftp_upload`.

20
app_my_webapp_fr.md Normal file
View file

@ -0,0 +1,20 @@
# Documentation My_webapp
En complément du Readme.md de l'application, voici des astuces utiles.
## Mise à jour automatique du contenu du site.
L'application créée un nouvel utilisateur avec des droits limités : il peut se connecter (avec un mot de passe) en SFTP pour accéder au dossier `/var/www/my_webapp` (ou `/var/www/my_webapp__<numero>` s'il y a plusieurs installations de cette appli).
Cette configuration oblige à mettre à jour le contenu du site à la main, avec une connexion à mot de passe.
Si vous souhaitez automatiser des choses, il vous faut une possibilité de connexion sans mot de passe à taper (dite "non-interactive"). Voici les étapes à suivre pour y arriver :
- Activer la connexion par clé publique, dans `/etc/ssh/sshd_config`, sur le serveur
- Créer une paire clé publique/privée pour votre script, sur l'ordinateur "de rédaction" - sans mettre de phrase de passe de protection.
- Copier la clé publique sur le serveur, dans `/var/www/my_webapp(__#)/.ssh/authorized_keys`
- Rentre l'utilisateur `webapp#` propriétaire du fichier et du dossier
- Vous pouvez maintenant vous connecter sans mot de passe, avec `sftp -b`, `lftp` ou bien d'autres clients SFTP.
NB : Le numéro de port à utiliser pour la connection SFTP est celui utilisé pour le SSH, et configuré dans `/etc/ssh/sshd_config`.
Cette asctuce vous permet de mettre à jour automatiquement votre site. Par exemple, le makefile de l'outil Pelican vous permet d'utiliser `make ftp_upload`.

View file

@ -62,7 +62,7 @@ Pour vérifier que tout s'est bien passé, comparer ce qu'affichent ces deux com
ls -la /home/yunohost.app/nextcloud
Cas A : ls -al /media/stockage
Cas B : ls -al /media/stockage/nextcloud_data
Cas B : ls -al /media/stockage/nextcloud_data/nextcloud
```
### Configurer Nextcloud
@ -83,7 +83,7 @@ Que vous modifiez :
```bash
CAS A : 'datadirectory' => '/media/stockage',
CAS B : 'datadirectory' => '/media/stockage/nextcloud_data',
CAS B : 'datadirectory' => '/media/stockage/nextcloud_data/nextcloud/data',
```
Sauvegardez avec `ctrl+x` puis `y` ou `o` (dépend de la locale de votre serveur).
@ -97,7 +97,7 @@ systemctl start nginx
Ajouter le fichier .ocdata
```bash
CAS A : nano /media/stockage/.ocdata
CAS B : nano /media/stockage/nextcloud_data/.ocdata
CAS B : nano /media/stockage/nextcloud_data/nextcloud/data/.ocdata
```
Ajouter un espace au fichier pour pouvoir le sauvegarder
@ -118,7 +118,7 @@ L'application KeeWeb est un gestionnaire de mots de passe incorporé à Nextclou
Mais il arrive parfois que Nextcloud ne laisse pas l'application prendre en charge ces fichiers, ce qui rend alors impossible leur lecture de KeeWeb. Pour remédier à cela,
[une solution](https://github.com/jhass/nextcloud-keeweb/issues/34) existe.
Ce rendre dans le répertoire de configuration de Nextcloud :
Se rendre dans le répertoire de configuration de Nextcloud :
```bash
cd /var/www/nextcloud/config/

View file

@ -1,3 +0,0 @@
# OpenVPN
To be written...

View file

@ -1,3 +0,0 @@
# OpenVPN
À documenter...

2
app_peertube.md Normal file
View file

@ -0,0 +1,2 @@
===== Peertube =====
PeerTube is a federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser, using WebTorrent.

5
app_pihole.md Normal file
View file

@ -0,0 +1,5 @@
===== Pihole =====
Homepage: https://pi-hole.net
**Pi-hole®** Network-wide ad blocking via your own DNS server, with nice Performance And Statistics web page.

23
app_pluxml.md Normal file
View file

@ -0,0 +1,23 @@
# PluXml
![PluXml_logo](images/PluXml_logo.png)
PluXml is a blog/CMS storing data in XML and not in a SQL database.
## Overview
![PluXml_screenshot](images/PluXml_screenshot.jpg)
## Plugins and themes
Plugins and themes should respectively be installed in the following folders : `/var/www/pluxml/plugins`, `/var/www/pluxml/themes`.
## Backup
To restore your blog, you should keep a copy of the folder `/var/www/pluxml/data`. It is recommended to do this backup before any upgrade.
## Link
PluXml : https://www.pluxml.org/
Documentation : https://wiki.pluxml.org/
Forum : https://forum.pluxml.org/

23
app_pluxml_fr.md Normal file
View file

@ -0,0 +1,23 @@
# PluXml
![PluXml_logo](images/PluXml_logo.png)
PluXml est un moteur de blog/CMS stockant ces données en XML et ne nécessitant pas de base de données SQL.
## Aperçu
![PluXml_screenshot](images/PluXml_screenshot.jpg)
## Plugins et thèmes
Les plugins et thèmes doivent être installés manuellement respectivement dans les dossiers `/var/www/pluxml/plugins` et `/var/www/pluxml/themes`.
## Sauvegarde
Pour sauvegarder votre blog, il est nécessaire de réaliser une copie du dossier `/var/www/pluxml/data`. Cette procédure de sauvegarde est également recommandée avant toute mise à jour de l'application.
## Liens
PluXml : https://www.pluxml.org/
Documentation : https://wiki.pluxml.org/
Forum : https://forum.pluxml.org/

View file

@ -8,12 +8,18 @@ Pour le configurer après l'installation, veuillez vous rendre sur http://DOMAIN
- Le mot de passe admin par défaut est : Mot de passe choisi lors de l'installation
- Si vous avez oublié votre mot de passe, vous pouvez le retrouver avec ``sudo yunohost app settings rainloop password``
Chaque utilisateur peut ajouter un carnet d'adresse distant CardDav via leur propre paramètres.
## Carnet d'adresses
Rainloop intègre par défaut un carnet d'adresse avec les utilisateurs du serveur yunohost. Chaque utilisateur peut ajouter un carnet d'adresse distant CardDav via leurs propres paramètres.
- Si vous utilisez Baikal, l'adresse à renseigner est du type : https://DOMAIN.TLD/baikal/card.php/addressbooks/UTILISATEUR/default/
- Si vous utilisez NextCloud, l'adresse à renseigner est du type : https://DOMAIN.TLD/nextcloud/remote.php/carddav/addressbooks/USER/contacts
Rainloop stocke les clés PGP privées dans le stockage de navigateur. Cela implique que vos clés seront perdues quand vous videz le stockage de navigateur (navigation incognito, changement d'ordinateur, ...). Ce paquet intègre [PGPback de chtixof](https://github.com/chtixof/pgpback_ynh) pour que vous puissiez stocker vos clés privées PGP de manière sécurisée sur le serveur. Rendez-vous **http://DOMAIN.TLD/rainloop/pgpback** pour stocker vos clés privées PGP sur le serveur ou les restaurer dans un nouveau navigateur.
## Gestion des domaines
Les utilisateurs peuvent se servir de Rainloop pour accéder à d'autres boites mail que celle fournie par yunohost (par exemple gmail.com ou laposte.net). L'option est disponible par le bouton "compte -> ajouter un compte".
L'administrateur doit pour cela autoriser la connexion à des domaines tiers, via une liste blanche dans l'interface administration.
## Gestion des clés PGP
Rainloop stocke les clés PGP privées dans le stockage de navigateur. Cela implique que vos clés seront perdues quand vous videz le stockage de navigateur (navigation incognito, changement d'ordinateur, ...). Ce paquet intègre donc [PGPback de chtixof](https://github.com/chtixof/pgpback_ynh) pour que vous puissiez stocker vos clés privées PGP de manière sécurisée sur le serveur. Rendez-vous à l'adresse **http://DOMAIN.TLD/rainloop/pgpback** pour stocker vos clés privées PGP sur le serveur ou les restaurer dans un nouveau navigateur.
## Mise à jour
Pour mettre à jour rainloop lorsqu'une nouvelle version est disponible, lancez en console locale (ssh ou autre) :
``sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop
``sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop``

6
app_yunofav.md Normal file
View file

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

View file

@ -1,5 +1,11 @@
# Apps
<span class="javascriptDisclaimer">
This page requires Javascript enabled to display properly :s.
<br/>
<br/>
</span>
<div class="input-group">
<span class="input-group-addon" id="basic-addon1"><span class="glyphicon glyphicon-search"></span></span>
<input type="text" id="filter-app-cards" class="form-control" placeholder="Search for apps..." aria-describedby="basic-addon1"/>

View file

@ -1,5 +1,11 @@
# <div dir="rtl">التطبيقات</div>
<span class="javascriptDisclaimer">
This page requires Javascript enabled to display properly :s.
<br/>
<br/>
</span>
<div dir="rtl" class="input-group">
<span class="input-group-addon" id="basic-addon1"><span class="glyphicon glyphicon-search"></span></span>
<input type="text" id="filter-app-cards" class="form-control" placeholder="البحث عن تطبيقات ..." aria-describedby="basic-addon1"/>

View file

@ -1,5 +1,11 @@
# Apps
<span class="javascriptDisclaimer">
Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
<br/>
<br/>
</span>
<div class="input-group">
<span class="input-group-addon" id="basic-addon1"><span class="glyphicon glyphicon-search"></span></span>
<input type="text" id="filter-app-cards" class="form-control" placeholder="Rechercher des apps..." aria-describedby="basic-addon1"/>

310
apps_it.md Normal file
View file

@ -0,0 +1,310 @@
# Apps
<span class="javascriptDisclaimer">
Questa pagina richiede Javascript abilitato per essere correttamente mostrata :s.
<br/>
<br/>
</span>
<div class="input-group">
<span class="input-group-addon" id="basic-addon1"><span class="glyphicon glyphicon-search"></span></span>
<input type="text" id="filter-app-cards" class="form-control" placeholder="Search for apps..." aria-describedby="basic-addon1"/>
<div class="input-group-btn">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
<span id="app-cards-list-filter-text">Solo app ufficiali</span> <span class="caret"></span>
</button>
<ul class="dropdown-menu">
<li><a href="#" id="app-cards-list-validated">Solo app ufficiali</a></li>
<li><a href="#" id="app-cards-list-working">Solo app funzionanti</a></li>
<li><a href="#" id="app-cards-list-working-inprogress">App in sviluppo/non funzionanti</a></li>
<li><a href="#" id="app-cards-list-all-apps">Tutte le app</a></li>
</ul>
</div>
</div>
<br />
<div id="community-app-list-warrant" class="alert alert-danger">
<p>Solo le app etichettate come <span class="label label-success label-as-badge">validate</span> sono ufficialmente supportate dalla squadra di packaging. </p>
<p>App etichettate come <span class="label label-success label-as-badge">funzionanti</span>, <span class="label label-warning label-as-badge">insviluppo</span>, <span class="label label-danger label-as-badge">nonfunzionanti</span> arrivano dai repository della comunità, puoi provare ed utilizzarle **a tuo rischio e pericolo**.</p>
<p>Importante: è il mantenitore dell'applicazione che indica l'applicazione come funzionante, non il team base di YunoHost. Installale a tuo rischio e pericolo. Noi non forniamo supporto per queste app.</p>
</div>
<div class="alert alert-info">I mantenitori apprezzeranno i tuoi consigli.Se le installi e incontri dei problemi, o idee per migliorarle, non esitare a segnalare la cosa direttamente nei rispettivi repository.</div>
<div class="app-cards-list" id="app-cards-list"></div>
<div class="alert alert-warning">Se non trovi l'app che stai cercando, puoi provarla a cercarla nel repository delle app della comunità (funzionanti, in sviluppo, non funzionanti) o aggiungila alla <a href="/apps_wishlist_en">lista delle app dei desideri</a>.</div>
<style>
/*=================================================
Search bar
=================================================*/
#filter-app-cards, #app-cards-list {
width:100%;
}
/*===============================================*/
/*=================================================
Force return space after card list
=================================================*/
#app-cards-list:after {
content:'';
display:block;
clear: both;
}
/*===============================================*/
/*=================================================
App card
=================================================*/
.app-card {
margin-bottom:20px;
width:270px;
float:left;
min-height: 1px;
margin-right: 10px;
margin-left: 10px;
}
/*===============================================*/
/*=================================================
App card body
=================================================*/
.app-card .panel-body > h3 {
margin-top:0;
margin-bottom:5px;
font-size:1.2em;
}
.app-card .category {
height:35px;
}
.app-card .category .label, .app-card-date-maintainer {
font-size:0.7em;
}
.app-card-date-maintainer {
text-align:right;
max-height: 18px;
margin-bottom: 3px;
margin-right: 7px;
margin-top: -5px;
}
.app-card .unmaintained {
color: #e0aa33;
}
.app-card-desc {
height:100px;
overflow: hidden;
}
/*===============================================*/
/*=================================================
App card footer
=================================================*/
.app-card .btn-group {
width:100%;
margin-left: 0px;
}
.app-card > .btn-group > .btn{
border-bottom:0;
}
.app-card > .btn-group > .btn:first-child {
border-left:0;
border-top-left-radius:0;
}
.app-card > .btn-group > .btn:last-child {
border-right:0;
border-top-right-radius:0;
margin-left: 0px;
width: 33.6%;
}
/*===============================================*/
</style>
<script type="text/template" id="app-template2">
<div class="app-card_{app_id} app-card panel panel-default">
<div class="panel-body">
<h3>{app_name}</h3>
<div class="category"></div>
<div class="app-card-desc">{app_description}</div>
</div>
<div class="app-card-date-maintainer">
<span class="glyphicon glyphicon-refresh"></span> {app_update} -
<span title="{maintained_help}" class="{maintained_state}"><span class="glyphicon glyphicon-{maintained_icon}"></span> {app_maintainer}</span>
</div>
<div class="btn-group" role="group">
<a href="{app_git}" target="_BLANK" type="button" class="btn btn-default col-sm-4"><span class="glyphicon glyphicon-globe" aria-hidden="true"></span> Codice</a>
<a href="#/app_{app_id}_en" target="_BLANK" type="button" class="btn btn-default col-sm-4"><span class="glyphicon glyphicon-book" aria-hidden="true"></span> Doc</a>
<a href="https://install-app.yunohost.org/?app={app_id}" target="_BLANK" type="button" class="btn btn-{app_install_bootstrap} col-sm-4 active"><span class="glyphicon glyphicon-plus" aria-hidden="true"></span> Installa</a>
</div>
</div>
</script>
<script>
function timeConverter(UNIX_timestamp) {
var a = new Date(UNIX_timestamp*1000);
var months = ['Gennaio','Febbraio','Marzo','Aprile','Maggio','Giugno','Luglio','Agosto','Settembre','Ottobre','Novembre','Dicembre'];
var year = a.getFullYear();
var month = months[a.getMonth()];
var date = a.getDate();
var hour = a.getHours();
var min = a.getMinutes();
if (hour < 10) { hour = '0' + hour; }
if (min < 10) { min = '0' + min; }
var time = date+' '+month+' '+year;//+' at '+hour+':'+min
return time;
}
$(document).ready(function () {
// Hide warrant about community list
$('#community-app-list-warrant').hide();
var filters = ["validated"];
function filter(){
var filters_text = filters.map(function(el) { return '.app-' + el;}).join(', ');
var valThis = $('#filter-app-cards').val().toLowerCase();
$('.app-card').each(function(){
var text = $(this).find('h3').text().toLowerCase();
(text.indexOf(valThis) == 0 && $(this).find(filters_text).length > 0) ? $(this).show() : $(this).hide();
});
(filters.indexOf("working") == -1) ?$('#community-app-list-warrant').hide():$('#community-app-list-warrant').show();
}
//=================================================
// Search & filter bar event
//=================================================
$('#filter-app-cards').keyup(filter);
$('#app-cards-list-validated').click(function(){
filters = ["validated"];
$('#app-cards-list-filter-text').text($('#app-cards-list-validated').text());
filter();
});
$('#app-cards-list-working').click(function(){
filters = ["validated", "working"];
$('#app-cards-list-filter-text').text($('#app-cards-list-working').text());
filter();
});
$('#app-cards-list-working-inprogress').click(function(){
filters = ["notworking", "inprogress"];
$('#app-cards-list-filter-text').text($('#app-cards-list-working-inprogress').text());
filter();
});
$('#app-cards-list-all-apps').click(function(){
filters = ["validated", "working", "inprogress", "notworking"];
$('#app-cards-list-filter-text').text($('#app-cards-list-all-apps').text());
filter();
});
//=================================================
//=================================================
// Upload apps lists
//=================================================
var app_list={};
$.when(
$.getJSON('https://app.yunohost.org/community.json', {}, function(community) {
app_list.community = $.map(community, function(el) { return el; });
}),
$.getJSON('https://app.yunohost.org/official.json', {}, function(official) {
app_list.official = $.map(official, function(el) { return el; });
})
).then(function() {
app_list = app_list.official.concat(app_list.community);
// Sort alpha
app_list.sort(function(a, b){
a_state = (a.state == "validated")?4:(a.state == "working")?3:(a.state == "inprogress")?2:1;
b_state = (b.state == "validated")?4:(b.state == "working")?3:(b.state == "inprogress")?2:1;
if (a_state < b_state || a_state == b_state && a.level < b.level || a_state == b_state && a.level == b.level && a.manifest.id > b.manifest.id) {return 1;}
else if (a.manifest.id == b.manifest.id) {return 0;}
return -1;
});
$.each(app_list, function(k, infos) {
app_id = infos.manifest.id;
app_install_bootstrap = "success";
if (infos.state === "validated") {
app_state_bootstrap = "success";
} else if (infos.state === "working") {
app_state_bootstrap = "success";
} else if (infos.state === "inprogress") {
app_state_bootstrap = "warning";
app_install_bootstrap = "danger";
} else if (infos.state === "notworking") {
app_state_bootstrap = "danger";
app_install_bootstrap = "danger";
}
if (infos.level == null ) {
infos.level = '?';
}
if (infos.level == 0 ) {
app_level_bootstrap = "danger";
app_install_bootstrap = "danger";
} else if (infos.level <= 2) {
app_level_bootstrap = "warning";
app_install_bootstrap = "danger";
} else if (infos.level >= 7) {
app_level_bootstrap = "success";
} else {
app_level_bootstrap = "default";
}
// Fill the template
html = $('#app-template2').html()
.replace(/{app_id}/g, app_id)
.replace(/{app_name}/g, infos.manifest.name)
.replace('{app_description}', infos.manifest.description.en)
.replace(/{app_git}/g, infos.git.url)
.replace('{app_branch}', infos.git.branch)
.replace('{app_level}', infos.level)
.replace('{app_update}', timeConverter(infos.lastUpdate))
.replace('{app_state_bootstrap}', app_state_bootstrap)
.replace('{app_install_bootstrap}', app_install_bootstrap);
if (infos.maintained == false)
{
html = html
.replace('{maintained_state}', 'unmaintained')
.replace('{maintained_icon}', 'warning-sign')
.replace('{app_maintainer}', "Non mantenuto")
.replace('{maintained_help}', "Questo pacchetto attualmente non è mantenuto. Sentiti libero di proporti come nuovo mantenitore !");
} else {
if (infos.manifest.developer) {
html = html
.replace('{maintained_state}', 'maintained')
.replace('{maintained_icon}', 'user')
.replace('{app_maintainer}', infos.manifest.developer.name)
.replace('{maintained_help}', "Mantenitore attuale di questo pacchetto");
}
if (infos.manifest.maintainer) {
html = html
.replace('{maintained_state}', 'maintained')
.replace('{maintained_icon}', 'user')
.replace('{app_maintainer}', infos.manifest.maintainer.name)
.replace('{maintained_help}', "Mantenitore attuale di questo pacchetto");;
}
}
// Fill the template
$('#app-cards-list').append(html);
$('.app-card_'+ app_id).attr('id', 'app-card_'+ app_id);
$('.app-card_'+ app_id + ' .category').append(' <span class="label label-'+app_level_bootstrap+' label-as-badge">'+infos.level+'</span>');
$('.app-card_'+ app_id + ' .category').append(' <span class="label label-'+app_state_bootstrap+' label-as-badge app-'+infos.state+'">'+infos.state+'</span>');
if (infos.manifest.license && infos.manifest.license != 'free') {
$('.app-card_'+ app_id + ' .category').append(' <span class="label label-default">'+infos.manifest.license+'</span>');
}
});
filter();
});
//=================================================
});
</script>

View file

@ -5,7 +5,7 @@ L'une des fonctionnalités principales de YunoHost est la possibilité d'install
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`.
Les applications peuvent être installées et gérées via l'interface webadmin dans la partie 'Applications', ou via les commandes de la catégorie `yunohost app`.
Listes d'applications
-----------------
@ -37,7 +37,7 @@ Certaines applications peuvent être installées plusieurs fois (à différents
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`.
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 app addaccess`, `removeaccess` et `clearaccess`.
Packaging d'applications
------------------------

View file

@ -31,6 +31,7 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [cgit](http://git.zx2c4.com/cgit/about)
- [CheckUp](https://sourcegraph.github.io/checkup)
- [CiviCRM](https://civicrm.org)
- [Cloud torrent](https://github.com/jpillora/cloud-torrent)
- [Cockpit](http://cockpit-project.org/)
- [Commafeed](https://github.com/Athou/commafeed)
- [Converse.js](https://conversejs.org)
@ -44,6 +45,8 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [DirectoryLister](https://github.com/DirectoryLister/DirectoryLister)
- [Discourse](https://discourse.org)
- [DNSchain](https://github.com/okTurtles/dnschain)
- [Domoticz](https://github.com/domoticz/domoticz)
- [Drupal](https://www.drupal.org/)
- [Emby](https://emby.media)
- [Emoncms](https://github.com/emoncms/emoncms)
- [ERPnext](https://erpnext.com/download)
@ -52,6 +55,7 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [Ferment](https://github.com/mmckegg/ferment)
- [FEX](http://fex.rus.uni-stuttgart.de/)
- [FileTea](https://filetea.me)
- [FitTrackee](https://github.com/SamR1/FitTrackee)
- [FoOlSlide](http://foolcode.github.io/FoOlSlide/) Open source comicbook/manga management software
- [Fossil](http://www.fossil-scm.org)
- [Framaslides](https://framagit.org/framasoft/framaslides/)
@ -68,6 +72,7 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [HackMD CE](https://github.com/hackmdio/hackmd)
- [Hackpad](https://github.com/dropbox/hackpad)
- [Headphones](https://github.com/rembo10/headphones)
- [Hexo](https://hexo.io/)
- [Hi Buddy](https://github.com/tOkeshu/hibuddy) (/!\ last update: 17 Feb 2015)
- [Huginn](https://github.com/cantino/huginn)
- [Hugo](http://gohugo.io)
@ -75,10 +80,12 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [ikiwiki](http://ikiwiki.info)
- [img.bi](https://github.com/imgbi/img.bi)
- [InfCloud](https://www.inf-it.com/open-source/clients/infcloud)
- [Invidious](https://github.com/omarroth/invidious)
- [Invoice Ninja](https://www.invoiceninja.com)
- [InvoicePlane](https://invoiceplane.com)
- [IPFS](https://ipfs.io)
- [Joplin](http://joplin.cozic.net/)
- [Jellyfin](https://github.com/jellyfin)
- [JS Bin](http://jsbin.com/help/2-second-setup)
- [Kaiwa](http://getkaiwa.com)
- [Keepass](http://keepass.info)
@ -99,7 +106,6 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [LiquidSoap](http://savonet.sourceforge.net/)
- [Logstalgia](http://logstalgia.io)
- [Loomio](https://www.loomio.org)
- [The Lounge](https://thelounge.github.io), cf. https://github.com/Kloadut/shout_ynh/issues/4
- [MaidSafe](http://maidsafe.net)
- [Mailpile](https://www.mailpile.is)
- [Matomo](https://matomo.org/) (formerly Piwik)
@ -117,6 +123,7 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [OpenBazaar](https://openbazaar.org)
- [openHAB](https://www.openhab.org/) - Smart home platform.
- [OpenJabNab](https://github.com/OpenJabNab/OpenJabNab) (/!\ last update: Apr 30, 2016)
- [OX Open-Xchange](https://www.open-xchange.com) Linux groupware solution
- [Paperless](https://github.com/danielquinn/paperless)
- [Paperwork](http://paperwork.rocks)
- [pdfy](https://github.com/joepie91/pdfy) (/!\ last update: Aug 5, 2014)
@ -168,6 +175,7 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [TwitRSS.me](http://twitrss.me/) ([Github](https://github.com/ciderpunx/twitrssme)) Scrapes Twitter to create RSS feeds.
- [Unvis](https://unv.is/) ([Github](https://github.com/lodjuret/unvis.it))
- [Vaultier](http://www.vaultier.org)
- [Volumio](https://volumio.org)
- [Webmpc](https://github.com/ushis/webmpc)
- [WebODF](http://webodf.org)
- [webSync](http://furier.github.io/websync)

View file

@ -54,35 +54,35 @@ For more informations and options about backup creation, consult `yunohost backu
#### Apps-specific configuration
Some apps such as nextcloud may be related to a large quantity of data which are not backuped by default. This practice is referred to "backing up only the core" (of the app). However it's possible to enable the backup of all data of this app with `yunohost app setting nextcloud backup_core_only -v 0`. Be careful though that your archive might get huge if there's too much data to be backuped...
Some apps such as Nextcloud may be related to a large quantity of data which are not backuped by default. This practice is referred to "backing up only the core" (of the app). However it's possible to enable the backup of all data of this app with `yunohost app setting nextcloud backup_core_only -v ''`. Be careful though that your archive might get huge if there's too much data to be backuped...
Downloading and uploading backups
---------------------------------
After creating backup archives, it is possible to list and inspect them via the corresponding views in the webadmin, or via `yunohost backup list` and `yunohost backup info <archivename>` from the command line. By default, backups are stored in `/home/yunohost.backup/archives/`.
There is currently no straightfoward way to dowload or upload a backup archive.
Currently, the most accessible way to download archives is to use the program FileZilla as explained in [this page](/filezilla).
One solution consists in using `scp` (a program based on [`ssh`](/ssh)) to copy files between two machines via the command line. Hence, from a machine running linux, you should be able to run the following to download a specific backup :
Alternatively, a solution can be to install Nextcloud or a similar app and configure it to be able to access files in `/home/yunohost.backup/archives/` from a web browser.
Finally, you can use `scp` (a program based on [`ssh`](/ssh)) to copy files between two machines via the command line. Hence, from a machine running Linux, you should be able to run the following to download a specific backup:
```bash
scp admin@your.domain.tld:/home/yunohost.backup/archives/<archivename>.tar.gz ./
```
Similarly, you can upload a backup from a machine to your server with
Similarly, you can upload a backup from a machine to your server with:
```bash
scp /path/to/your/<archivename>.tar.gz admin@your.domain.tld:/home/yunohost.backup/archives/
```
Alternatively, a solution can be to install Nextcloud or a similar app and configure it to be able to access files in `/home/yunohost.backup/archives/` from a web browser.
Restoring backups
-----------------
#### From the webadmin
Go in Backup > Local storage and select your archive. You can then select which items you want to restore, then click 'Restore'.
Go in Backup > Local storage and select your archive. You can then select which items you want to restore, then click on 'Restore'.
![](/images/restore.png)
@ -90,18 +90,24 @@ Go in Backup > Local storage and select your archive. You can then select which
From the command line, you can run `yunohost backup restore <archivename>` (without the `.tar.gz`) to restore an archive. As for `yunohost backup create`, this will restore everything in the archive by default. If you want to restore only specific items, you can use for instance `yunohost backup restore --apps wordpress` which will restore only the wordpress app.
#### Constrains
#### Constraints
To restore an app, the domain on which it was installed should already be configured (or you need to restore the corresponding system configuration). You also cannot restore an app which is already installed ... which means that to restore an old version of an app, you must first uninstall it.
#### Restoring during the postinstall
One specific feature is the ability to restore a full archive *instead* of the postinstall step. This makes it useful when you want to reinstall a system entirely from an existing backup. To be able to do this, you will need to upload the archive on the server and place it in `/home/yunohost.backup/archives` though. Then, instead of `yunohost tools poinstall` you can run :
One specific feature is the ability to restore a full archive *instead* of the postinstall step. This makes it useful when you want to reinstall a system entirely from an existing backup. To be able to do this, you will need to upload the archive on the server and place it in `/home/yunohost.backup/archives`. Then, **instead of** `yunohost tools postinstall` you can run:
```bash
yunohost backup restore <archivename>
```
Note: If your archive isn't in `/home/yunohost.backup/archives`, you can specify where it is like this :
```bash
yunohost backup restore /path/to/<archivename>
```
To go futher
------------
@ -143,7 +149,7 @@ Alternatively, the app Archivist allows to setup a similar system : https://foru
If you are using an ARM board, another method for doing a full backup can be to create an image of the SD card. For this, poweroff your ARM board, get the SD card in your computer then create a full image with something like :
```bash
dd if=/dev/mmcblk0 of=./backup.img
dd if=/dev/mmcblk0 of=./backup.img status=progress
```
(replace `/dev/mmcblk0` with the actual device of your sd card)

View file

@ -8,7 +8,7 @@ Les sauvegardes avec YunoHost
YunoHost contient un système de sauvegarde, qui permet de sauvegarder (et restaurer) les configurations du système, les données "système" (comme les mails) et les applications si elles le supportent.
Vous pouvez gérer vos sauvegardes via la ligne de commande (`yunohost backup --help`) ou la webadmin (dans la section Sauvegardes) bien que certaines fonctionnalités ne soient pas disponible via celle-ci.
Vous pouvez gérer vos sauvegardes via la ligne de commande (`yunohost backup --help`) ou la webadmin (dans la section Sauvegardes) bien que certaines fonctionnalités ne soient pas disponibles via celle-ci.
Actuellement, la méthode de sauvegarde actuelle consiste à créer des archives `.tar.gz` qui contiennent les fichiers pertinents. Pour le futur, YunoHost envisage de supporter nativement [Borg](https://www.borgbackup.org/) qui est une solution plus flexible, performante et puissante pour gérer des sauvegardes.
@ -17,7 +17,7 @@ Créer des sauvegardes
#### Depuis la webadmin
Vous pouvez facilement créer des archives depuis la webadmin en allant dans Sauvegardes > Archives locales et en cliquant sur "Nouvelle sauvegarde". Vous pourrez ensuite sélectionner quoi sauvegarder (configuration, données "système", applications).
Vous pouvez facilement créer des archives depuis la webadmin en allant dans Sauvegardes > Archives locales et en cliquant sur "Nouvelle sauvegarde". Vous pourrez ensuite sélectionner les éléments à sauvegarder (configuration, données "système", applications).
![](/images/backup.png)
@ -50,33 +50,33 @@ yunohost backup create --system data_mail
yunohost backup create --system data_mail --apps wordpress
```
Pour plus d'informations et d'option sur la création d'archives, consultez `yunohost backup create --help`. Vous pouvez également lister les parties de système qui sont sauvegardable avec `yunohost hook list backup`.
Pour plus d'informations et d'options sur la création d'archives, consultez `yunohost backup create --help`. Vous pouvez également lister les parties de système qui sont sauvegardables avec `yunohost hook list backup`.
#### Configuration spécifiques à certaines apps
#### Configuration spécifique à certaines apps
Certaines apps comme Nextcloud sont potentiellement rattachées à des quantités importantes de données, qui ne sont pas sauvegardées par défaut. Dans ce cas, on dit que l'app "sauvegarde uniquement le core" (de l'app). Néanmoins, il est possible d'activer la sauvegarde de toutes les données de cette application avec (dans le cas de Nextcloud) `yunohost app setting nextcloud backup_core_only -v 0`. Soyez prudent: en fonction des données stockées dans nextcloud, il se peut que l'archive que vous obtenez ensuite devienne énorme...
Certaines apps comme Nextcloud sont potentiellement rattachées à des quantités importantes de données, qui ne sont pas sauvegardées par défaut. Dans ce cas, on dit que l'app "sauvegarde uniquement le core" (de l'app). Néanmoins, il est possible d'activer la sauvegarde de toutes les données de cette application avec (dans le cas de Nextcloud) `yunohost app setting nextcloud backup_core_only -v ''`. Soyez prudent : en fonction des données stockées dans Nextcloud, il se peut que l'archive que vous obtenez ensuite devienne énorme...
Télécharger et téléverser des sauvegardes
-----------------------------------------
Après avoir créé des sauvegardes, il est possible de les lister et de les inspecter grâce aux vues correspondantes dans la webadmin, ou via `yunohost backup list` et `yunohost backup info <nom_d'archive>` depuis la ligne de commande. Par défaut, les sauvegardes sont stockées dans `/home/yunohost.backup/archives/`.
Il n'existe actuellement pas de solution "rapide et facile" pour télécharger ou téléverser une archive depuis une autre machine.
À l'heure actuelle, la solution la plus accessible pour récupérer les sauvegardes est d'utiliser le programme FileZilla comme expliqué dans [cette page](/filezilla_fr).
Une solution consiste à utiliser `scp` (un programme basé sur [`ssh`](/ssh)) pour copier des fichiers entre deux machines grâce à la ligne de commande. Ainsi, depuis une machine sous Linux, vous pouvez utiliser la commande suivante pour télécharger une archive:
Une autre solution alternative consiste à installer une application comme Nextcloud et à la configurer pour être en mesure d'accéder aux fichiers dans `/home/yunohost.backup/archives/` depuis un navigateur web.
Enfin, il est possible d'utiliser `scp` (un programme basé sur [`ssh`](/ssh)) pour copier des fichiers entre deux machines grâce à la ligne de commande. Ainsi, depuis une machine sous Linux, vous pouvez utiliser la commande suivante pour télécharger une archive :
```bash
scp admin@your.domain.tld:/home/yunohost.backup/archives/<nom_d'archive>.tar.gz ./
```
De façon similaire, vous pouvez téléverser une sauvegarde depuis une machine vers votre serveur avec:
De façon similaire, vous pouvez téléverser une sauvegarde depuis une machine vers votre serveur avec :
```bash
scp /path/to/your/<nom_d'archive>.tar.gz admin@your.domain.tld:/home/yunohost.backup/archives/
```
Une solution alternative consiste à installer une application comme Nextcloud et à la configurer pour être en mesure d'accéder aux fichiers dans `/home/yunohost.backup/archives/` depuis un navigateur web.
Restaurer des sauvegardes
-------------------------
@ -96,12 +96,22 @@ Pour restaurer une application, le domaine sur laquelle elle est installée doit
#### Restauration d'une archive à la place de la post-installation
Une fonctionnalité particulière est la possibilité de restaurer une archive entière *à la place* de faire la post-installation. Ceci est utile pour réinstaller un système entièrement à partir d'une sauvegarde existante. Pour faire cela, il vous faudra d'abord téléverser l'archive sur le server et la placer dans `/home/yunohost.backup/archives`. Ensuite, à la place de `yunohost tools poinstall` vous pouvez faire:
Une fonctionnalité particulière est la possibilité de restaurer une archive entière *à la place* de faire la post-installation. Ceci est utile pour réinstaller un système entièrement à partir d'une sauvegarde existante. Pour faire cela, il vous faudra d'abord téléverser l'archive sur le serveur et la placer dans `/home/yunohost.backup/archives`.
Ensuite, **à la place de** `yunohost tools postinstall`, réalisez la restauration de l'archive téléversée par cette ligne de commande avec le nom de l'archive (sans le `.tar.gz`) :
```bash
yunohost backup restore <nom_d'archive>
```
Note: si votre archive n'est pas dans `/home/yunohost.backup/archives`, vous pouvez spécifier où elle se trouve comme ceci :
```bash
yunohost backup restore /path/to/<archivename>
```
Pour aller plus loin
--------------------
@ -117,33 +127,32 @@ ln -s $PATH_TO_DRIVE/yunohost_backup_archives /home/yunohost.backup/archives
#### Sauvegardes automatiques
Vous pouvez ajouter une tâche cron pour déclencher automatiquement une sauvegarde régulièrement. Par exemple pour sauvegarder l'application wordpress toutes les semaines, créez un fichier `/etc/cron.weekly/backup-wordpress` avec le contenu suivant:
Vous pouvez ajouter une tâche cron pour déclencher automatiquement une sauvegarde régulièrement. Par exemple pour sauvegarder l'application wordpress toutes les semaines, créez un fichier `/etc/cron.weekly/backup-wordpress` avec le contenu suivant :
```bash
#!/bin/bash
yunohost backup create --apps wordpress
```
puis rendez-le exécutable:
puis rendez-le exécutable :
```bash
chown +x /etc/cron.weekly/backup-wordpress
```
Soyez prudent à propos de ce que vous sauvegardez et de la fréquence: il vaut mieux éviter de se retrouver avec un disque saturé car vous avez voulu sauvegarder 30 Go de données tous les jours...
Soyez prudent à propos de ce que vous sauvegardez et de la fréquence : il vaut mieux éviter de se retrouver avec un disque saturé car vous avez voulu sauvegarder 30 Go de données tous les jours...
#### Sauvegarder sur un serveur distant
Vous pouvez suivre ce tutoriel sur le forum pour mettre en place Borg entre deux serveurs: https://forum.yunohost.org/t/how-to-backup-your-yunohost-server-on-another-server/3153
Vous pouvez suivre ce tutoriel sur le forum pour mettre en place Borg entre deux serveurs : https://forum.yunohost.org/t/how-to-backup-your-yunohost-server-on-another-server/3153
Il existe aussi l'application Archivist qui permet un système similaire: https://forum.yunohost.org/t/new-app-archivist/3747
Il existe aussi l'application Archivist qui permet un système similaire : https://forum.yunohost.org/t/new-app-archivist/3747
#### Backup complet avec `dd`
Si vous êtes sur une carte ARM, une autre méthode pour créer une sauvegarde complète consiste à créer une image (copie) de la carte SD. Pour cela, éteignez votre serveur, insérez la carte SD dans votre ordinateur et créez une image avec une commande comme:
Si vous êtes sur une carte ARM, une autre méthode pour créer une sauvegarde complète consiste à créer une image (copie) de la carte SD. Pour cela, éteignez votre serveur, insérez la carte SD dans votre ordinateur et créez une image avec une commande comme :
```bash
dd if=/dev/mmcblk0 of=./backup.img
dd if=/dev/mmcblk0 of=./backup.img status=progress
```
(remplacez `/dev/mmcblk0` par le vrai nom de votre carte SD)

View file

@ -1,6 +1,6 @@
# Certificate
Certificates are used to certify that your server is the genuine one, and not an attacker trying to impersonate it.
Certificates are used to guarantee the confidentiality and authenticity of the communication between a web browser and your server. In particular, they protect against attackers trying to impersonate your server.
YunoHost provides a **self-signed** certificate, it means that your server guaranties the certificate validity. It's enough **for personal usage**, because you trust your own server. But this could be a problem if you want to open access to anonymous like web user for a website.

View file

@ -1,6 +1,6 @@
# Certificat
Un certificat est utilisé pour garantir la confidentialité des échanges entre votre serveur et votre client.
Les certificats sont utilisés pour garantir la confidentialité et l'authenticité des communications entre un navigateur web et votre serveur. En particulier, il permet de protéger les visiteurs contre des attaquants qui chercheraient à usurper l'identité du serveur.
YunoHost fournit par défaut un certificat **auto-signé**, ce qui veut dire que cest votre serveur qui garantit la validité du certificat. Cest suffisant **pour un usage personnel**, car vous pouvez avoir confiance en votre serveur, en revanche cela posera problème si vous comptez ouvrir laccès à votre serveur à des anonymes, par exemple pour héberger un site web.
En effet, les utilisateurs devront passer par un écran de ce type :

View file

@ -1,185 +0,0 @@
Certificate management
======================
Managing certificates with Yunohost
-----------------------------------
The main feature of the certificate manager is to allow you to install Let's
Encrypt certificate on your domains without pain. You can use it from the web
administration (*SSL certificate* on a given domain info page), or from the
command line with `yunohost domain cert-status`, `cert-install` and
`cert-renew`.
#### What is required to be able to have a Let's Encrypt certificate ?
Your server needs to be reachable from the rest of Internet on port 80 (and
443), and make your `domain.tld` points to your server's public IP in your DNS
configuration. See [this documentation](diagnostic_en) if you need help.
#### Will my certificate be automatically be renewed ?
Yes. Right now, Let's Encrypt certificates are valid 90 days. A cron job will
run every day and attempt to renew any certificate that will expire in less than
15 days. An email will be sent to the root user if a renewal fails.
#### I want/need to use a certificate from a different CA than Let's Encrypt.
This cannot be done automatically for now. You will need to manually create a
Certificate Signing Request (CSR) to be given to your CA, and manually import
the certificate you get from it. Check out [this page](certificate) for more
info. This process might be made easier by Yunohost in the future.
Migration procedure
--------------------
> Because of the current [rate limits](https://letsencrypt.org/docs/rate-limits/)
on new Let's Encrypt certificate emissions, we recommend that you **do not
migrate** to the new built-in management feature **as long as you don't need to**.
This is especially true for nohost.me / noho.st users (and other domains services
sharing a common subdomain). If too many people migrate during the same period
of time, you might get stuck with a self-signed certificate for a few days !
#### I used the *letsencrypt_ynh* app
You will be asked to uninstall the app before being able to use the new
management feature. You can do it from the web administration interface, or from
the command line with :
```bash
yunohost app remove letsencrypt
yunohost domain cert-install
```
Be aware that the first command will revert your domains to self-signed
certificate. The second command will attempt to reinstall a Let's Encrypt
certificate on all your domains which have a self-signed certificate.
#### I manually installed my Let's Encrypt certificates
You should go in your nginx configuration, and remove the `letsencrypt.conf` (or
whatever you called the file containing the `location
'/.well-known/acme-challenge'` block) for each of your domains. Also remove the symlink
to your current certificates :
```bash
rm /etc/yunohost/certs/your.domain.tld/key.pem
rm /etc/yunohost/certs/your.domain.tld/crt.pem
```
Then run :
```bash
yunohost domain cert-install your.domain.tld --force --self-signed
yunohost domain cert-install your.domain.tld
```
for each of your domains you want a Let's Encrypt certificate.
Finally, remove your certificate renewer cron job in `/etc/cron.weekly/`, then backup and remove you `/etc/letsencrypt/` folder.
Troubleshooting
---------------
#### Admin interfaces says the letsencrypt app is installed, but it's not, and I can't access the certificate management interface !
Make sure you refresh the cache of your browser (Ctrl + Shift + R on Firefox),
and report the issue on the forum or on the bugtracker. You can work around the
issue by using `yunohost domain cert-install your.domain.tld` from the command
line.
#### I tried to uninstall the letsencrypt app, but it broke my nginx conf !
Sorry about that. Some user reported that this happens when the uninstallation
script fails to find a backup of your self-signed certificate. Running `yunohost
domain cert-install` should work anyway...
#### I get "Too many certificates already issued", what's happening ?
Currently, Let's Encrypt has a rate limit of issuing no more than 20 new
certificates by period of 7 days for a given subdomains. For example, `nohost.me`
and `noho.st` are already considered as subdomains themselves, meaning all users
of the nohost.me / noho.st service share the same common limit. According to
Let's Encrypt, this applies for *new* certificates, but not for renewals or
duplicates. If you encounter this limit, there isn't much to do except retrying
a few days later.
#### Certificate installation fails, says "Wrote file to 'some path', but couldn't download 'some url'" !
This should be fixed in the future, but for now you might need to manually add the
following line in your `/etc/hosts` :
```bash
127.0.0.1 your.domain.tld
```
About certificates and Let's Encrypt
------------------------------------
#### What is HTTPS ? What's the point of SSL certificates ?
HTTPS is the secure version of the HTTP protocol, which describes how a client
(e.g. a web browser) and a server (e.g. nginx running on your Yunohost
instance) can talk to each other. HTTPS heavily relies on [asymmetric
cryptography](https://en.wikipedia.org/wiki/Public-key_cryptography) to achieve
two things :
- confidentiality, meaning that an attacker will not be able to decrypt the content of the communication if it is intercepted ;
- server's identification, meaning that a server can prove he is who it says it is, thus protecting against [man-in-the-middle attacks](https://en.wikipedia.org/wiki/Man-in-the-middle_attack).
SSL certificates is the technology used for server to prove their identity. The
whole process relies on trust in third parties called Certification Authorities
(CA), whose role is to verify the server identity (e.g. that a given machine
effectively controls the domain `ilikecoffee.com`) before delivering
[cryptographic certificates](https://en.wikipedia.org/wiki/Public_key_certificate).
#### Why do browsers complain about self-signed certificates ?
Self-signed certificates are, as their name says, self-signed, meaning that you
were your own certification authority in the process. Such a certificate does
not allow to verify your server's identity, since it could have easily been
generated by an attacker on its own, attempting to perform man-in-the-middle
attacks.
#### What's up with Let's Encrypt ?
Historically, the process of verifying the identity of a server often required
human intervention, time and money.
In 2015, Let's Encrypt, developped a protocol called
[ACME](https://en.wikipedia.org/wiki/Automated_Certificate_Management_Environment),
which allows to automatically verify that a machine controls a domain, and deliver
certificates for free, drastically reducing the cost of setting up a SSL
certificate.
#### How does Let's Encrypt works ?
To verify your server's identity and deliver the certificate, Let's Encrypt uses
the [ACME
protocol](https://en.wikipedia.org/wiki/Automated_Certificate_Management_Environment). It
basically works as follow (it's simplified, but you'll get the idea) :
- A program running on your server contacts the Let's Encrypt CA server, ask for
a certificate for domain `ilikecoffee.com`.
- The Let's Encrypt CA server generates a random string such as `A84F2D0B`, and
tells the program on your server to prove it operates the domain
`ilikecoffee.com` by making the URI `http://ilikecoffee.com/.well-known/acme-challenge/A84F2D0B`
accessible.
- The program on your server edit/creates files accordingly.
- The Let's Encrypt CA server attempt to access the URI. If it works, then it
concludes the program indeed operates the domain `ilikecoffee.com`. It
delivers a certificate.
- The program on your server obtains the certificate and setups it.
#### Do we really need Certification Authorities ?
The reliance on Certification Authorities can be criticized, as they represent
points of failure in the security scheme. Some trusted CAs have been found to
issue rogue certificates in the past, sometimes with critical implications
[[1](http://www.darkreading.com/endpoint/authentication/fake-google-digital-certificates-found-and-confiscated/d/d-id/1297165),
[2](https://reflets.info/microsoft-et-ben-ali-wikileaks-confirme-les-soupcons-d-une-aide-pour-la-surveillance-des-citoyens-tunisiens/)].
Alternatives have been proposed, such as
[DANE/DNSSEC](https://en.wikipedia.org/wiki/DNS-based_Authentication_of_Named_Entities),
which is based on the DNS system does not require certification authorities.

View file

@ -1,179 +0,0 @@
Gestion du certificat
======================
Gérer les certificats avec YunoHost
-----------------------------------
La fonctionnalité principale du gestionnaire de certificat est de permettre l'installation
de certificat Let's Encrypt facilement sur vos domaines. Vous pouvez l'utiliser depuis
l'interface d'admin web (*Certificat SSL* sur la page d'info d'un domaine), ou avec
la ligne de commande avec `yunohost domain cert-status`, `cert-install` et `cert-renew`.
#### De quoi ai-je besoin pour avoir un certificat Lets Encrypt ?
Votre serveur doit être accessible depuis le reste d'Internet sur le port 80 (et 443),
et le DNS de votre `nom.de.domaine.tld` doit être correctement configuré (i.e. le
domaine doit pointer sur l'IP publique de votre serveur). Vous pouvez vous aider
de [cette documentation](diagnostic_fr) si vous avez besoin d'aide.
#### Est-ce que mon certificat sera renouvelé automatiquement ?
Oui. À l'heure actuelle, les certificats Let's Encrypt sont valides pendant 90 jours.
Une tâche automatique (cron job) sera exécutée tous les jours pour renouveler les certificats
qui expirent dans moins de 15 jours. Un email sera envoyé à l'utilisateur root si le
renouvellement échoue.
#### Je souhaite/jai besoin dutiliser un certificat dune autre autorité de certification
Ceci n'est pas géré automatiquement pour le moment. Il vous faudra créer manuellement
une demande de signature de certificat (CSR) qui devra être donné à votre CA, puis importer
le certificat obtenu. Plus d'informations sur [cette page](certificate_fr). Ce processus sera
peut-être rendu plus facile par YunoHost dans le futur.
Procédure de migration
--------------------
> À cause des [limitations actuelles](https://letsencrypt.org/docs/rate-limits/)
sur la fréquence d'émissions de nouveaux certificats Let's Encrypt, nous recommandons que
vous ne **migriez pas** vers cette nouvelle fonctionnalité **tant que vous n'en avez pas besoin**.
C'est en particulier vrai pour les utilisateurs de nohost.me / nohost.st (et d'autres services de
nom de domaine gratuit qui partagent un sous-domaine commun). Si trop de monde migrent
pendant la même période, vous vous retrouverez peut-être bloqué avec un certificat auto-signé
pendant quelques jours !
#### Jai utilisé lapplication *letsencrypt_ynh*.
Il vous sera demandé de désinstaller l'application pour pouvoir utiliser la nouvelle gestion
de certificat. Vous pouvez procéder à la désinstallation depuis l'interface web, ou bien depuis
la ligne de commande avec :
```bash
yunohost app remove letsencrypt
yunohost domain cert-install
```
Soyez conscients que la première commande devrait remettre en place des certificats
auto-signés sur vos domaines. La deuxième commande tentera ensuite d'installer un certificat
Let's Encrypt sur chacun de vos domaines ayant un certificat auto-signé.
#### Jai installé mes certificats Lets Encrypt manuellement
Il vous faut aller dans la configuration nginx et retirer les fichiers `letsencrypt.conf` (ou le nom que
vous lui avez donné et qui contient un bloc `location '/.well-known/acme-challenge'`) pour chacun
de vos domaines. Retirez les liens symboliques vers vos certificats actuels :
```bash
rm /etc/yunohost/certs/your.domain.tld/key.pem
rm /etc/yunohost/certs/your.domain.tld/crt.pem
```
Puis tapez les commandes suivantes :
```bash
yunohost domain cert-install your.domain.tld --force --self-signed
yunohost domain cert-install your.domain.tld
```
pour chacun des domaines pour lesquels vous souhaitez avoir un certificat Let's Encrypt.
Finalement, supprimez la tâche automatique (certificateRenewer) dans `/etc/cron.weekly/`,
et backupez puis supprimez le répertoire `/etc/letsencrypt/`.
Dépannage
---------------
#### Linterface dadmin bloque laccès à linterface de gestion du certificat en prétendant que lapp letsencrypt est installée, pourtant elle nest pas là !
Assurez-vous que le cache du navigateur est bien rafraîchi (Ctrl + Shift + R sur Firefox).
Si cela ne résous pas le problème, rapportez votre expérience sur le bugtracker ou le forum.
Vous pouvez contourner le problème en utilisant la commande :
`yunohost domain cert-install your.domain.tld`.
#### Jai essayé de désinstaller lapplication Lets Encrypt, mais cela a cassé ma configuration nginx !
Désolé. Quelques utilisateurs ont rapporté que cela arrive lorsque le script de désinstallation ne trouve pas
de backup des certificats auto-signés. Utiliser `yunohost domain cert-install` devrait tout de même fonctionner…
#### Jobtiens "Too many certificates already issued", que se passe-t-il ?
Pour l'instant, Let's Encrypt a mis en place un taux limite d'émission de certificat, qui
est de 20 nouveaux certificats pendant une période de 7 jours pour un sous-domaine donné.
Par exemple, les domaines `nohost.me` et `noho.st` sont considérés comme des sous-domaines
(des domaines `me` et `st`). ce qui veut dire que tous les utilisateurs du service nohost.me / noho.st
partagent une même limite commune. D'après Let's Encrypt, ceci s'applique aux *nouveaux* certificats,
mais pas aux renouvellements ou duplications. Si vous rencontrez ce message, il n'y a donc pas grand
chose à faire dautre que ré-essayer dans quelques heures/jours.
#### Linstallation du certificat échoue avec "Wrote file to 'un chemin', but couldn't download 'une url'" !
Cela devrait être réparé dans le futur, mais pour le moment vous pouvez tenter d'ajouter la ligne suivante
au fichier `/etc/hosts` du serveur :
```bash
127.0.0.1 your.domain.tld
```
À propos des certificats et de Lets Encrypt
------------------------------------
#### Quest-ce que HTTPS ? À quoi servent les certificats SSL ?
HTTPS est la version sécurisée du protocole HTTP, qui décrit comment un client
(par ex. votre navigateur web) et un serveur (par ex. nginx qui tourne sur votre instance
YunoHost) peuvent discuter entre eux. HTTPS s'appuie fortement sur la [cryptographie
asymmétrique](https://en.wikipedia.org/wiki/Public-key_cryptography) pour garantir
deux choses :
- la confidentialité, ce qui veut dire qu'un attaquant ne sera pas capable de déchiffrer le contenu d'une communication si elle est interceptée ;
- l'identification du serveur, ce qui veut dire qu'un serveur peut et doit prouver qui il prétend être, dans le but d'éviter les [attaques man-in-the-middle](https://en.wikipedia.org/wiki/Man-in-the-middle_attack).
Les certificats SSL sont utilisés par les serveurs pour prouver leur identité.
Le processus général repose sur la confiance en des tiers, appelés Autorité
de Certification (CA), dont le rôle est de vérifier l'identité d'un serveur (par ex.
qu'une machine donnée contrôle bien le domaine `jaimelecafe.com`) avant
de délivrer des [certificats cryptographiques](https://en.wikipedia.org/wiki/Public_key_certificate).
#### Pourquoi est-ce que les navigateurs se plaignent de mon certificat auto-signé ?
Les certificats auto-signés sont, comme leur nom l'indique, auto-signés, ce qui veut
dire que le serveur était sa propre autorité de certification lorsqu'il a créé le certificat.
Un tel certificat ne permet pas de vérifier et garantir l'identité du serveur, puisqu'il
aurait tout aussi pu être généré par un attaquant de son côté, dans le but de réaliser
une attaque man-in-the-middle.
#### Que se passe-t-il avec Lets Encrypt ?
Historiquement, le processus de vérification de l'identité des serveurs demandait une
intervention humaine, donc du temps et de la monnaie.
En 2015, Let's Encrypt a développé un protocole nommé
[ACME](https://en.wikipedia.org/wiki/Automated_Certificate_Management_Environment),
qui permet de vérifier automatiquement qu'une machine contrôle un domaine, et de
délivrer un certificat gratuitement, réduisant drastiquement le coût de mise en place
d'un certificat SSL.
#### Comment fonctionne Lets Encrypt ?
Pour vérifier l'identité de votre serveur et délivrer un certificat, Let's Encrypt utilise
le [protocole ACME](https://en.wikipedia.org/wiki/Automated_Certificate_Management_Environment).
Il fonctionne grosso-modo de la manière suivante (simplifiée, mais vous comprendrez l'idée) :
- Un programme tourne sur votre serveur et contacte l'autorité de certification Let's Encrypt et
lui demande un certificat pour le domaine `jaimelecafe.com`.
- L'autorité de certification Let's Encrypt génère une chaîne de caractères aléatoire comme `A84F2D0B`, et
dit au programme sur votre serveur de prouver qu'il gère le domaine `jaimelecafe.com` en rendant l'URI
`http://jaimelecafe.com/.well-known/acme-challenge/A84F2D0B` accessible.
- Le programme sur votre serveur créé/modifie des fichiers en conséquence.
- La CA Let's Encrypt tente d'accéder à l'URI. Si cela fonctionne, elle conclue que le programme contrôle
bien le domaine `jaimelecafe.com`, et lui délivre un certificat.
- Le programme sur votre serveur récupère le certificat et le met en place.
#### A-t-on vraiment besoin des autorités de certification ?
La dépendance aux autorités de certification peut être critiquée, car elles constituent des points centraux
vulnérables dans le schéma de sécurité. Certaines autorités ont été reconnues coupable d'avoir délivré
de faux certificats par le passé, parfois avec des implications sérieuses et très concrètes.
[[1](http://www.darkreading.com/endpoint/authentication/fake-google-digital-certificates-found-and-confiscated/d/d-id/1297165),
[2](https://reflets.info/microsoft-et-ben-ali-wikileaks-confirme-les-soupcons-d-une-aide-pour-la-surveillance-des-citoyens-tunisiens/)].
Des alternatives ont été proposées, comme [DANE/DNSSEC](https://en.wikipedia.org/wiki/DNS-based_Authentication_of_Named_Entities),
qui repose sur les DNS et ne nécessite pas d'autorité de certification.

View file

@ -32,3 +32,11 @@ It also allow to discuss packaging evolution, continuous integration tools :
- IRC: **#yunohost-apps** on irc.freenode.net
- Matrix: **#freenode_#yunohost-apps:matrix.org**
- XMPP: **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
#### Documentation chatroom
Yunohost project documentation chat room. It allow people to discuss, synchronize and maintain
an up-to-date documentation on the differents aspects of the project (backend, frontend, apps, project, community...).
You may also share here your public communications about Yunohost (videos, presentations, etc.), to allow proper referencing.
- IRC: **#yunohost-doc** on irc.freenode.net
- Matrix: **#freenode_#yunohost-doc:matrix.org**
- XMPP: **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)**

View file

@ -29,3 +29,10 @@ Il sert également à discuter de lévolution du packaging, des outils din
- IRC : **#yunohost-apps** sur irc.freenode.net
- Matrix : **#freenode_#yunohost-apps:matrix.org**
- XMPP : **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
#### Documentation
Le salon de documentation du projet Yunohost. Il permet aux contributeurs d'échanger, pour synchroniser et maintenir une documentation à jour sur les différents aspects du projet : backend, frontend, apps, projet, communauté...
Vous pouvez aussi y partager vos communications au public à propos de Yunohost (présentations, vidéos...) pour permettre leur référencement dans la documentation.
- IRC: **#yunohost-doc** sur irc.freenode.net
- Matrix: **#freenode_#yunohost-doc:matrix.org**
- XMPP: **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)**

28
collabora_en.md Normal file
View file

@ -0,0 +1,28 @@
# Install Collabora with Nextcloud, using Docker
**Note :** This walkthrough is based on a Debian 8 instance, and has not been tested since version 3 upgrade of Yunohost. As a prerequisite, you must have configured your domains and sub-domains in the DNS, in compliance with : [DNS](/dns_en), [Sub-domain install of an app](/dns_subdomains_en), [DNS settings](/dns_config_en) and [noho.st / nohost.me / ynh.fr domains](/dns_nohost_me)).
### 0. Install Nextcloud
If Nextcloud is not already installed on your Yunohost instance, you may do so with this link : [Install Nextcloud](https://install-app.yunohost.org/?app=nextcloud)
### 1. Install Collabora app within yunohost
**In the admin interface :**
Applications > Install > at the bottom _Install a custom application_ > enter this url « https://github.com/aymhce/collaboradocker_ynh » > Enter the domain/subdomain name you wish for the Collabora application.
### 2. Configuration within Nextcloud
**Add the Collabora Online application in Nextcloud :**
Click on the user icon (top right) > Applications > Desktop & Text > Under the « Collabora Online » tile, click on `Activate` .
**Setup Collabora in Nextcloud :**
Click on the user icon (top right) > Parametres > Under _Administration_, _Collabora Online_ .
Specify the « Online Collabora server » with the domain name chosen during the collabora install in Yunohost (full with « https:// »).
### 3. Reboot
To allow all the pieces to work, system must be reboot. You can do so through the admin interface (Tools > Stop/reboot > `Reboot`) or via the command line interface : ``sudo reboot now``.
## Debugging
Following some system, Yunohost or app updates, Collabora may display an error message such as "It's embarrassing...". To put things back in order, you just have to restart the docker machine, with the command ``systemctl restart docker``.

View file

@ -1,26 +1,31 @@
# Installer Collabora avec Nextcloud
# Installer Collabora avec Nextcloud via Docker
**Note :** la marche à suivre detaillée et realisée ici à partir dune instance Yunohost sur Debian 8 (celle-ci n'a pas été testée suite a la migration sur la version 3 de Yunohost) et celle-ci part du principe que les domaines/sous-domaines sont correctement configurés au niveau des DNS et de votre instance Yunohost (voir [DNS](/dns_fr) , [DNS et installation dune application sur un sous-domaine](/dns_subdomains_fr) ,[Configurer les enregistrements DNS](/dns_config_fr) et [Nom de domaine en noho.st / nohost.me](/dns_nohost_me_fr) )
**Note :** la marche à suivre detaillée est réalisée ici à partir dune instance Yunohost sur Debian 8 (celle-ci n'a pas été testée suite à la migration vers la version 3 de Yunohost). Ces instructions ont pour pré-requis que les domaines/sous-domaines sont correctement configurés au niveau des DNS et de votre instance Yunohost (voir [DNS](/dns_fr), [DNS et installation dune application sur un sous-domaine](/dns_subdomains_fr), [Configurer les enregistrements DNS](/dns_config_fr) et [Nom de domaine en noho.st / nohost.me / ynh.fr](/dns_nohost_me_fr)).
### Installer Nextcloud
### 0. Installer Nextcloud
Si Nexcloud n'est pas déja installée sur votre instance Yunohost, vous pouvez linstaller depuis le lien suivant :
[Installer nextcloud](https://install-app.yunohost.org/?app=nextcloud)
Si l'application Nexcloud n'est pas déja installée sur votre instance Yunohost, vous pouvez linstaller depuis le lien suivant : [Installer Nextcloud](https://install-app.yunohost.org/?app=nextcloud)
### Installer l'application Collabora dans yunohost
**dans l'interface d'Administration :**
Applications > Installer > En bas de la page _Installer une application personnalisée_ > Renseigner lurl « https://github.com/aymhce/collaboradocker_ynh » > Définir le nom de domaine secondaire/sous-domaine dédié à l'application Collabora .
### 1. Installer l'application Collabora dans yunohost
**dans l'interface d'administration :**
Applications > Installer > En bas de la page _Installer une application personnalisée_ > Renseigner lurl « https://github.com/aymhce/collaboradocker_ynh » > Définir le nom de domaine secondaire/sous-domaine dédié à l'application Collabora.
### Configuration dans nextcloud
### 2. Configuration dans Nextcloud
**Ajouter l'application Collabora Online à Nextcloud :**
Cliquer sur l'icone de l'utilisateur en haut à droite > Applications > Bureautique & texte > Sous « Collabora Online » cliquer sur Activer
Cliquer sur l'icône de l'utilisateur en haut à droite > Applications > Bureautique & texte > Sous « Collabora Online » cliquer sur `Activer` .
**Configurer Collabora sur Nextcloud :**
Cliquer sur l'icone de l'utilisateur en haut à droite > Paramètres > Sous _Administration_, _Collabora en ligne_
Cliquer sur l'icone de l'utilisateur en haut à droite > Paramètres > Sous _Administration_, _Collabora en ligne_ .
Renseigner le « Serveur Collabora en ligne » par le nom de domaine choisi lors de linstallation de collabora dans yunohost (précédé de « https:// »).
### 3. Reboot
Pour permettre la mise en marche du lien collabora-Nextcloud, le système doit être rebooté. Faisable depuis l'interface d'administration : Outils > Arrêter/redémarrer > `Redémarrer`. Ou depuis la ligne de commande : ``sudo reboot now``.
## Débug
Suite à certaines mises à jour du système, de yunohost ou des applications, Collabora peut afficher un message d'erreur du type "c'est embarrassant...". Pour remettre les choses en marche, il suffit de redémarrer la machine docker, avec la commande ``systemctl restart docker``.

View file

@ -5,7 +5,7 @@ L'interface en ligne de commande (CLI) est, en informatique, la manière origina
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).
<div class="alert alert-info" markdown="1">
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 !
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 rassuré qu'il n'y a pas besoin d'être un expert pour commencer à l'utiliser !
</div>
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`.)

View file

@ -2,6 +2,8 @@
## Talks / conf
* (FR) [Capitole du libre 2018 - YunoHost: un des chemins vers la décentralisation - Bram](https://www.youtube.com/watch?v=OEXEStoOYpw) ([slides](https://psycojoker.github.io/yunohost-cdl-2018/))
* (FR) [Journées du logiciel libre 2018 - YunoHost : vers lauto-hébergement et au-delà - Bram](https://www.videos-libr.es/videos/watch/45b48b1e-1b10-4e09-b29a-a404bd42c5d0) ([slides](https://psycojoker.github.io/yunohost-jdll-2018/))
* (FR) [Capitole du libre 2017 - YunoHost : vers l'auto-hébergement et au-delà - JimboJoe](https://2017.capitoledulibre.org/programme/#yunohost-vers-lauto-hebergement-et-au-dela) ([slides](https://github.com/YunoHost/yunohost-cdl-2017/raw/master/YunoHost-CDL2017.pdf))
* (FR) [PSES 2017 Construire lInternet du Futur avec YunoHost Aleks, ljf](https://data.passageenseine.org/2017/aleks-ljf_internet-futur-yunohost.webm) ([slides](https://data.passageenseine.org/2017/aleks-ljf_internet-futur-yunohost.pdf))
* (FR) [Université de technologie de compiègne 2017 Agir pour un internet éthique LJF](http://webtv.utc.fr/watch_video.php?v=O34AA7RBR1AH)

View file

@ -1,22 +0,0 @@
#Contributors
Here is a non exhaustive list of mains contributors.
* kload
* beudbeud
* jerome: main dev of [Moulinette](moulinette)
* opi: main dev of [web admin](admin)
* ju: apps
* Moul:
* Documentation
* Cubieboard
* moul[at]moul.re
* courgette: design
* titoko

View file

@ -1,55 +0,0 @@
#Contributeurs
Liste non exhaustive des principaux contributeurs :
#### Fondateurs
* kload
* beudbeud
#### Conseil
* Bram
* ju
* ljf
* Maniack
* Moul
* opi
* Théodore
#### Groupe Core Dev
* AlexAubin
* Bram
* Ju
* ljf
* Moul
* opi
#### Groupe Apps
* Bram
* Ju
* ljf
* Maniack C
* Moul
* Scith
* Tostaki
#### Groupe Communication
* Bram
* Moul
* ljf
* opi
* Théodore
* Jean-Baptiste
#### Groupe Distribution
* Heyyounow
#### Autres contributeurs
* jerome : développeur de la [Moulinette](moulinette_fr)
* courgette : design
* titoko
* Genma

View file

@ -83,13 +83,11 @@ Improve this documentation by [writing new pages](/write_documentation) or trans
<div class="col col-md-8" markdown="1">
Extend YunoHost capabilities by [packaging new services and web applications](/packaging_apps).
Have a look of [what has been done yet](/apps)!
<br>
A <a href="http://list.yunohost.org/cgi-bin/mailman/listinfo/apps">mailing-list</a> is available.
</div>
</div>
---
<br>
<p class="lead" markdown="1">In any case, please [come to dev chatroom](xmpp:dev@conference.yunohost.org?join) to contribute :-)</p>
<p class="lead" markdown="1">In any case, please come chat with us on [the dev chatroom](/chat_rooms) :-)</p>

View file

@ -79,8 +79,6 @@ Améliorez cette documentation en [proposant de nouvelles pages](/write_document
</div>
<div class="col col-md-8" markdown="1">
Étendez les capacités de YunoHost en [packageant de nouveaux services et applications web](/packaging_apps_fr). Jetez un œil à [ce qui a déjà été fait](/apps_fr)!
<br>
Un [salon de développement](xmpp:dev@conference.yunohost.org?join) et une <a href="http://list.yunohost.org/cgi-bin/mailman/listinfo/apps">mailing-list</a> est également disponible.
</div>
</div>
@ -88,5 +86,5 @@ Un [salon de développement](xmpp:dev@conference.yunohost.org?join) et une <a hr
<br>
<br>
<p class="lead" markdown="1">Dans tous les cas, venez sur le [salon de développement](xmpp:dev@conference.yunohost.org?join) pour contribuer :-)</p>
<p class="lead" markdown="1">Dans tous les cas, venez discuter avec nous sur [le salon de développement](/chat_rooms_fr) :-)</p>

View file

@ -2,6 +2,7 @@
* [General ways of contributing to YunoHost](/contribute)
* [Writing documentation](/write_documentation)
* [Chat rooms](/chat_rooms)
* Application packaging
* [Apps wishlist](/apps_wishlist)
* [General introduction to app packaging](/packaging_apps_start)
@ -29,4 +30,4 @@
* [x86 ISO](https://github.com/YunoHost/cd_build)
* [Raspberry Pi images](https://github.com/YunoHost/rpi-image)
* [Other ARM board images](https://github.com/YunoHost/arm-images)
* [Using the YunoHost API outside of the webadmin](/admin_api_fr)
* [Using the YunoHost API outside of the webadmin](/admin_api)

View file

@ -2,6 +2,7 @@
* [Liste des façons de contribuer à YunoHost](/contribute_fr)
* [Écrire de la documentation](/write_documentation_fr)
* [Salons de discussion](/chat_rooms_fr)
* Packaging d'application
* [Liste d'apps souhaitées par la communauté](/apps_wishlist_fr)
* [Introduction générale au packaging d'apps](/packaging_apps_start_fr)

View file

@ -34,7 +34,7 @@ dd if=/path/to/yunohost.img of=/dev/mmcblk0
## Expand the root partition <small>(optional)</small>
<div class="alert alert-warning" markdown="1">
This step is optionnal as it should be performed automatically during the first
This step is optional as it should be performed automatically during the first
boot on recent images.
</div>

View file

@ -25,7 +25,7 @@ Connectez votre carte SD, sélectionnez votre image YunoHost, puis cliquez sur
### Avec `dd`
Si vous êtes sous Linux / Mac et que vous être à l'aise avec la ligne de
Si vous êtes sous Linux / Mac et que vous êtes à l'aise avec la ligne de
commande, vous pouvez aussi flasher votre carte SD avec `dd`. Commencez par
identifier le périphérique correspondant à votre carte SD avec `fdisk -l` ou
`lsblk`. En supposant que votre carte SD soit `/dev/mmcblk0` (faites attention

View file

@ -2,7 +2,7 @@
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 adress to validate your submission.
** Note: ** You will need to provide an email address to validate your submission.
###Syntax

11
default_it.md Normal file
View file

@ -0,0 +1,11 @@
#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
Questa pagina usa la sintassi markdown, per favore fai riferimento alla documentazione per ulteriori informazioni:
http://daringfireball.net/projects/markdown/syntax

4
dns.md
View file

@ -10,7 +10,7 @@ DNS stands for "Domain Name Server", and is often used for the configuration of
**For example**: `yunohost.org` points to the server at `88.191.153.110`.
This system was created to more easily keep track of server addresses. There are DNS registries for Internet names that you must register with. They are called "registrars", which will let you rent certain domain names for a price (between $5 or a few hundred, depending on the root domain and the chosen name). These [registrars](registrar) are private entities authorised by [ICANN](http://en.wikipedia.org/wiki/ICANN), such as [OVH](https://www.ovh.co.uk/index.xml), [Gandi](http://gandi.net), [NameCheap](http://namecheap.com) or [BookMyName](http://bookmyname.com).
This system was created to more easily keep track of server addresses. There are DNS registries for Internet names that you must register with. They are called "registrars", which will let you rent certain domain names for a price (between $5 or a few hundred, depending on the root domain and the chosen name). These [registrars](registrar) are private entities authorised by [ICANN](http://en.wikipedia.org/wiki/ICANN), such as [OVH](https://www.ovh.co.uk/index.xml), [Gandi](http://gandi.net), [NameCheap](http://namecheap.com) or [BookMyName](http://bookmyname.com). A privacy respecting registrar is [Njalla](https://njal.la/) or [Njalla Onion Site](njalladnspotetti.onion). With Njalla, you can register a domain name with just an email or XMPP address (N.B. : you won't have full control and ownership of the domain though).
It is important to note that subdomains do not necessarily have to send you to wherever the principal domain is pointing. If `yunohost.org` sends to `88.191.153.110`, that doesn't mean that `backup.yunohost.org` has to point at the same IP. You must therefore configure **all** of the domains and subdomains that you want to use.
@ -22,7 +22,7 @@ There are also different **types** of DNS records, which means that a domain can
You have several choices here. Note that you can mix and match solutions if you have multiple domains: for example, you can have `my-server.nohost.me` using solution **1.**, and `my-server.org` using solution **2.**, both leading to the same Yunohost server.
1. You can use YunoHost's DNS service, which will automatically configure your DNS for you. You must choose a domain that ends with `.nohost.me`, `.noho.st` or `.ynh.fr` for this, which may be inconvenient for you (you would then only be able to use an email address like `john@my-server.noho.st`).
1. You can use [YunoHost's DNS service](/dns_nohost_me), which will automatically configure your DNS for you. You must choose a domain that ends with `.nohost.me`, `.noho.st` or `.ynh.fr` for this, which may be inconvenient for you (you would then only be able to use an email address like `john@my-server.noho.st`).
**This is the recommended option if you are just starting out with self-hosting.**

View file

@ -31,7 +31,7 @@ La configuration recommandée ressemble typiquement à :
@ 3600 IN A 111.222.33.44
* 3600 IN A 111.222.33.44
# (Si votre serveur supporter l'IPv6, il a des enregistrements AAAA)
# (Si votre serveur supporte l'IPv6, il a des enregistrements AAAA)
@ 3600 IN AAAA 2222:444:8888:3333:bbbb:5555:3333:1111
* 3600 IN AAAA 2222:444:8888:3333:bbbb:5555:3333:1111

View file

@ -1,40 +1,39 @@
# DNS with a dynamic IP
<div class="alert alert-warning">Before going further, make sure your global IP address is dynamic with: [ip.yunohost.org](http://ip.yunohost.org/). The global IP address of your box change almost every days.</div>
<div class="alert alert-warning">Before going further, make sure your global IP address is dynamic with: [ip.yunohost.org](http://ip.yunohost.org/). The global IP address of your box changes almost every day.</div>
This tutorial aim to get around dynamic IP issue who's nest: when the IP address public of the box change, the DNS zone is not update to point towards the new IP address.
This tutorial aim to get around dynamic IP issue which is: when the IP public address of your (Internet Service Provider-) box changes, the DNS zone is not updated to point towards the new IP address, and consequently your server is no more reachable via its domain name. After setting up the solution proposed in this tutorial, the redirection from your domain name to the actual IP address of your server will not be lost anymore.
After put in place the solution proposed in this tutorial, the redirection from your domain name to the real IP address will not be loose anymore.
The method proposed here consists of automatizing the fact the box annonces its global IP adress change to the dynamic DNS, so that the DNS zone will automatically be updated.
The method which will be put in place consist to make automatic the fact the box annonce to the dynamic DNS it has change global IP address, and then the DNS zone will automatically be changed.
If you own a domain name at **OVH**, you could go to step 4 and follow this [tutorial](OVH_fr) because OVH propose a DynDNS service.
If you own a domain name at **OVH**, you may go to step 4 and follow this [tutorial](OVH_fr), given that OVH proposes a DynDNS service.
#### 1. Create an account to a Dynamic DNS service
Here is sites which offer a DynDNS service free of charge:
Here are sites which offer a DynDNS service free of charge:
* [DNSexit](https://www.dnsexit.com/Direct.sv?cmd=dynDns)
* [No-IP](https://www.noip.com/remote-access)
* [ChangeIP](https://changeip.com)
* [DynDNS (in italian)](https://dyndns.it)
* [DynDNS with your own domain](https://github.com/jodumont/DynDNS-with-HE.NET)
Register to one of them.
Register to one of them. It should provide you with one (or more) IP address to reach the service, and a login (that you may be able to self-define).
#### 2. Move the DNS zones
Move the [DNS zones](dns_config), excepted the NS fields, from the [registrar](registrar_en) where you bought your domain name to the dynamic DNS service you registrer at step 1.
Copy the [DNS zones](dns_config), except for the NS fields, from the [registrar](registrar_en) where you bought your domain name from to the dynamic DNS service you registrer at in step 1.
#### 3. Toggle management of your domain name to the dynamic DNS server
This step consist to say to the [registrar](registrar_en) that DNS service will be manage by the DynDNS service.
Redirect NS field to the IP address gived by the DynDNS service.
#### 3. Switch the management of your domain name to the dynamic DNS server
This step consists in declaring to your [registrar](registrar_en) that the DNS service will now be managed by the DynDNS service provider.
Then, remove [DNS zones](dns_config), excepted NS fields, from the [registrar](registrar_en).
For this, fisrt declare in the NS field(s) the IP address provided by the DynDNS service.
#### 4. Create a Dynamic DNS login
On the dynamic DNS service create a login that you will enter on a dynamic DNS client.
This client could be your box or a package installed on your server as `ddclient`.
We gone use the client installed on the box which is more easy way.
Then, remove any other item in the [DNS zones](dns_config) (except the previous NS fields), from the [registrar](registrar_en).
#### 5. Configure the box
Put the login of the dynamic DNS and the [public IP address](http://ip.yunohost.org/) on your box.
#### 4. Configure the client
This client could be your ISP-box, or a package installed on your server, such as `ddclient`.
Here, we will use the client provided by the box, which is the more easy way.
Enter the login of the dynamic DNS and its public IP address in your box (interface details may vary by ISP).
<img src="/images/dns_dynamic-ip_box_conf.png" width=600>
You're good to go !

View file

@ -27,7 +27,7 @@ Il existe également des **types** denregistrement DNS, ce qui veut dire qu
Plusieurs choix soffrent à vous. Notez que vous pouvez cumuler ces solutions si vous possédez plusieurs domaines : par exemple vous pouvez avoir `mon-serveur.nohost.me` en utilisant la solution **1.**, et `mon-serveur.org` en utilisant la solution **2.**, redirigeant vers le même serveur YunoHost.
1. Vous pouvez utiliser le service de DNS de YunoHost, qui soccupera de configurer tout seul les DNS de votre instance YunoHost. Vous devrez en revanche choisir un domaine se terminant par `.nohost.me`, `.noho.st` ou `.ynh.fr`, ce qui peut être inconvenant (vous aurez alors des adresses email telles que `jean@mon-serveur.noho.st`).
1. Vous pouvez utiliser [le service de DNS de YunoHost](/dns_nohost_me_fr), qui soccupera de configurer tout seul les DNS de votre instance YunoHost. Vous devrez en revanche choisir un domaine se terminant par `.nohost.me`, `.noho.st` ou `.ynh.fr`, ce qui peut être inconvenant (vous aurez alors des adresses email telles que `jean@mon-serveur.noho.st`).
**Cest la méthode recommandée si vous débutez.**
2. Vous pouvez utiliser le service de DNS de votre **registrar** (Gandi, OVH, BookMyName ou autre) pour configurer vos noms de domaine. Voici la [configuration DNS standard](/dns_config_fr). Il est aussi possible d'utiliser une redirection DNS locale, plus d'infos sur comment [Accéder à son serveur depuis le réseau local](/dns_local_network_fr).

55
dns_nohost_me.md Normal file
View file

@ -0,0 +1,55 @@
# Nohost.me domains
In order to make self-hosting as accessible as possible, YunoHost offers a *free*
and *automatically configured* domain name service. By using this service, you
won't have to [configure DNS records](/dns_config) yourself, which
can be tedious and technical.
The following (sub)domains are proposed:
- `whateveryouwant.nohost.me`;
- `whateveryouwant.noho.st`;
- `whateveryouwant.ynh.fr`.
To use this service, you simply have to choose such a domain during the
post-installation. It will then be automatically configured by YunoHost !
#### Retrieve a nohost.me or noho.st domain
If you reinstall your server and want to use a domain already used previously,
you must request a domain reset on the forum
[in the dedicated thread](https://forum.yunohost.org/t/nohost-domain-recovery/442).
#### Subdomains
The `nohost.me` and `noho.st` domain service does not allow the creation of
subdomains.
Even if YunoHost allows the installation of applications on subdomains (for
example, having the Owncloud application accessible from the
`cloud.mydomain.org` address), this feature is not allowed with the `nohost.me`
and `noho.st` domains and it is not possible to have a subdomain such as `my
application.mydomain.nohost.me`.
To be able to enjoy applications that can only be installed at the root of a
domain name, you must have your own domain name.
### Adding a nohost.me / noho.st / ynh.fr domain after the post-installation
If you already did the postinstall and want to add a nohost.me domain, you
should run the following command (this can only be done from command line
currently).
N.B. : you can only have *one* nohost.me domain per YunoHost installation.
```bash
# Add the domain
yunohost domain add whateveryouwant.nohost.me
# Subscribe/register to the dyndns service
yunohost dyndns subscribe -d whateveryouwant.nohost.me
# [ wait ~ 30 seconds ]
# Update the DNS conf
yunohost dyndns update
```

View file

@ -1,35 +1,17 @@
# Noms de domaines nohost.me
### Présentation
Afin de rendre l'auto-hébergement le plus accessible possible, YunoHost propose un service de noms de domaine *gratuits* et *automatiquement configurés*. En utilisant ce service, vous n'avez donc pas à réaliser vous-même la [configuration des enregistrements DNS](/dns_config) qui est assez technique.
Afin de rendre l'auto-hébergement le plus accessible possible, YunoHost offre un service de DNS dynamique par l'intermédiaire des noms de domaine `nohost.me` et `noho.st`. Si vous n'avez pas de nom de domaine, vous pouvez donc obtenir un sous-domaine de type `mondomaine.nohost.me` ou `mondomaine.noho.st`. Pour profiter de ce service, choisissez un domaine se terminant en `.nohost.me` ou `.noho.st`, il sera automatiquement rattaché à votre serveur YunoHost, et vous naurez pas détape de configuration supplémentaire.
### Obtenir un domaine
##### Depuis l'interface d'administration
Vous pouvez obtenir un domaine directement depuis l'interface d'administration de YunoHost, en vous rendant dans le menu "Domaines" et en cliquant sur le bouton "Ajouter un domaine" :
<img src="/images/dns_nohost_me.png" height=150 style="vertical-align:bottom">
##### En ligne de commande
Après vous être connecté à votre serveur YunoHost, entrez la commande (en remplaçant `mondomaine` par le domaine que vous souhaitez acquérir) :
```bash
sudo yunohost domain add mondomaine.nohost.me
```
Vous pouvez ensuite vérifier la création du domaine avec la commande :
```bash
sudo yunohost domain list
```
Les (sous-)domaines suivants sont proposés :
- `cequevousvoulez.nohost.me` ;
- `cequevousvoulez.noho.st` ;
- `cequevousvoulez.ynh.fr`.
Pour profiter de ce service, il vous suffit de choisir un tel domaine lors de la post-installation. Il sera ensuite automatiquement configuré par YunoHost !
### Récupérer un domaine nohost.me ou noho.st
Il peut arriver qu'une mise à jour des DNS du domaine soit nécessaire (par exemple lors d'un changement de machine), pour cela vous pouvez poster votre demande de réinitialisation sur le forum, [un fil est dédié à ce sujet](https://forum.yunohost.org/t/nohost-domain-recovery/442).
Si vous réinstallez votre serveur et voulez utiliser un domaine déjà utilisé précédemment, il vous faut demander une réinitialisation du domaine sur le forum [dans le fil de discussion dédié](https://forum.yunohost.org/t/nohost-domain-recovery/442).
### Sous-domaines
@ -38,3 +20,26 @@ Le service de domaines `nohost.me` et `noho.st` n'autorise pas la création de s
Même si YunoHost permet l'installation d'applications sur des sous-domaines (par exemple avoir l'application Owncloud accessible depuis l'adresse `cloud.mondomaine.org`), cette fonctionnalité n'est pas permise avec les domaines `nohost.me` et `noho.st` et il nest pas possible davoir un sous-sous-domaine tel `monapplication.mondomaine.nohost.me`.
Pour pouvoir profiter des applications installables uniquement à la racine dun nom de domaine, il faut avoir son propre nom de domaine.
### Ajouter un domaine nohost.me / noho.st / ynh.fr après la post-installation
Si vous avez déjà effectué la postinstallation est souhaitez ajouter un domaine
de type nohost.me, vous pouvez utiliser les commandes suivantes (uniquement
faisable depuis la ligne de commande pour le moment).
N.B. : vous ne pouvez avoir qu'*un* seul domaine nohost.me par installation de
YunoHost.
```bash
# Ajouter le domaine
yunohost domain add cequevousvoulez.nohost.me
# Enregister le domaine dans le service dyndns
yunohost dyndns subscribe -d cequevousvoulez.nohost.me
# [ attendre ~ 30 seconds ]
# Mettre à jour la configuration DNS
yunohost dyndns update
```

View file

@ -3,7 +3,7 @@
<div class="alert alert-danger">
<b>
Yunohost doesn't support Docker officially since issues with versions 2.4+.
In question, YunoHost 2.4 doesn't work anymore on Docker
In question, YunoHost 2.4+ doesn't work anymore on Docker
because YunoHost requires systemd and Docker has chosen to not support it natively (and
there are other problems link to the firewall and services).
</b>
@ -14,8 +14,10 @@ there are other problems link to the firewall and services).
However, community images exist and are available on Docker Hub :
* AMD64 (classic)
* https://hub.docker.com/r/domainelibre/yunohost2/ (Yunohost v2.7)
* https://hub.docker.com/r/domainelibre/yunohost3/ (Yunohost v3)
* I386 (old computers)
* https://hub.docker.com/r/domainelibre/yunohost3-i386/ (Yunohost v3)
* ARMV7 (raspberry pi 2/3 ...)
* https://hub.docker.com/r/domainelibre/yunohost2-arm/ (Yunohost v2.7)
* https://hub.docker.com/r/domainelibre/yunohost3-arm/ (Yunohost v3)
* ARMV6 (raspberry pi 1)
* https://hub.docker.com/r/tuxalex/yunohost-armv6/
* https://hub.docker.com/r/tuxalex/yunohost-armv6/ (old yunohost version)

View file

@ -13,9 +13,11 @@ services).
Cependant il existe des images communautaires disponibles sur Docker Hub :
* AMD64 (classique)
* https://hub.docker.com/r/domainelibre/yunohost2/ (Yunohost v2.7)
* ARMV7 (raspberry pi 2/3 ...)
* https://hub.docker.com/r/domainelibre/yunohost2-arm/ (Yunohost v2.7)
* ARMV6 (raspberry pi 1)
* https://hub.docker.com/r/tuxalex/yunohost-armv6/
* AMD64 (classique)
* https://hub.docker.com/r/domainelibre/yunohost3/ (Yunohost v3)
* I386 (anciens pc)
* https://hub.docker.com/r/domainelibre/yunohost3-i386/ (Yunohost v3)
* ARMV7 (raspberry pi 2/3 ...)
* https://hub.docker.com/r/domainelibre/yunohost3-arm/ (Yunohost v3)
* ARMV6 (raspberry pi 1)
* https://hub.docker.com/r/tuxalex/yunohost-armv6/ (ancienne version de Yunohost)

33
docs_de.md Normal file
View file

@ -0,0 +1,33 @@
#Documentation
<p class="lead">
Die YunoHost Dokumentation ist in 3 Bereiche aufgeteilt:
</p>
<div class="row text-center">
<div class="col col-md-4 col-md-offset-1">
<a class="btn btn-success btn-lg" href="/userdoc"><span class="glyphicon glyphicon-user"></span> Benutzerhandbuch</a>
<p><small class="text-muted">Über die tägliche Nutzung des Servers und Anleitungen zur Konfiguration des Clients.</small></p>
</div>
<div class="col col-md-4 col-md-offset-1">
<a class="btn btn-primary btn-lg" href="/admindoc"><span class="glyphicon glyphicon-lock"></span> Handbuch für Administratoren</a>
<p><small class="text-muted">Befasst sich mit den Installationsschritten und der Verwaltung von Server und Apps.</small></p>
</div>
<div class="col col-md-5 col-md-offset-3">
<a class="btn btn-danger btn-lg" href="/contributordoc"><span class="glyphicon glyphicon-heart"></span> Handbuch für Mitwirkende</a>
<p><small class="text-muted">Alles, was du über uns und unsere Art zu arbeiten wissen musst.</small></p>
</div>
</div>
* Das Projektleben:
* [Häufig gestellte Fragen](/faq_en)
* [Projektorganisation](/project_organization)
* [Blog](https://forum.yunohost.org/c/announcement)
* [Forum](https://forum.yunohost.org)
* [Chaträume](/chat_rooms_en)
* [Kommunikation](/communication_en)
* [Support / Hilfe](/help)

33
docs_it.md Normal file
View file

@ -0,0 +1,33 @@
#Documentazione
<p class="lead">
La documentazione di YunoHost ha 3 differenti sezioni:
</p>
<div class="row text-center">
<div class="col col-md-4 col-md-offset-1">
<a class="btn btn-success btn-lg" href="/userdoc"><span class="glyphicon glyphicon-user"></span> Guida utente</a>
<p><small class="text-muted">Sull'utilizzo giornaliero del tuo server e con alcune configurazioni per client "HOW-TOs"</small></p>
</div>
<div class="col col-md-4 col-md-offset-1">
<a class="btn btn-primary btn-lg" href="/admindoc"><span class="glyphicon glyphicon-lock"></span> Guida di amministrazione</a>
<p><small class="text-muted">Include l'installazione, la gestione del server e delle applicazioni</small></p>
</div>
<div class="col col-md-5 col-md-offset-3">
<a class="btn btn-danger btn-lg" href="/contributordoc"><span class="glyphicon glyphicon-heart"></span> Guida del contributore</a>
<p><small class="text-muted">Contiene tutto quello che devi sapere su di noi e su come lavoriamo</small></p>
</div>
</div>
* Vita del progetto :
* [Frequently asked questions](/faq_en)
* [Project organization](/project_organization)
* [Blog](https://forum.yunohost.org/c/announcement)
* [Forum](https://forum.yunohost.org)
* [Chat rooms](/chat_rooms_en)
* [Communication](/communication_en)
* [Supporto / Aiuto](/help_it)

View file

@ -3,7 +3,7 @@ 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.
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, so you can 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.
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, so you can manage the [DNS configuration](dns). The exception is the [domains `.nohost.me`, `.noho.st` and `ynh.fr`](/dns_nohost_me) which are free and can be directly integrated with YunoHost.
The domain chosen 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`.
@ -19,7 +19,7 @@ YunoHost can generate a recommended DNS configuration for each domain, including
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](certificates) for more information.
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
----------------------------------------

View file

@ -3,7 +3,7 @@ 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.
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`](/dns_nohost_me_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`.
@ -19,7 +19,7 @@ YunoHost peut générer une configuration DNS recommandée pour chaque domaine,
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.
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_fr) pour plus d'informations.
Sous-chemins vs. domaines individuels par application
-----------------------------------------------------

View file

@ -30,7 +30,7 @@ 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@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.
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 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 ?
-----------------------------------------------

View file

@ -30,7 +30,7 @@ Configuration des alias de messagerie et des redirections automatiques
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.
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 autre fonctionnalité méconnue est l'utilisation de suffixe commencant par "+". Par exemple, les emails envoyés à `johndoe+sncf@votre.domaine.tld` atteriront dans le dossier 'sncf' de la boîte mail de John Doe (ou bien directement dans la boîle mail si ce dossier n'existe pas). 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.
Que se passe-t-il si mon serveur devient indisponible ?
-----------------------------------------------

View file

@ -28,9 +28,9 @@ It may yield something like this :
```bash
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sda 8:0 0 931.5G 0 disk
└─sda1 8:1 0 931.5G 0 part
mmcblk0 179:0 0 14.9G 0 disk
sda 8:0 0 931.5G 0 disk
└─sda1 8:1 0 931.5G 0 part
mmcblk0 179:0 0 14.9G 0 disk
├─mmcblk0p1 179:1 0 47.7M 0 part /boot
└─mmcblk0p2 179:2 0 14.8G 0 part /
```
@ -41,20 +41,11 @@ Here, `mmcblk0` corresponds to an SD card of 16Go (the partitions `mmcblk0p1` et
<span class="glyphicon glyphicon-warning-sign"></span> On a different setup, your system partition might be `sda` and so your external drive might be `sdb` for instance.
</div>
## 2. (Optionnal) Format the disk
## 2. (Optional) Format the disk
If you want, you can format the disk before starting to use it. You should be aware that **formating a drive implies to erasing every data on it !** If your disk is already "clean", you may ignore this step.
This operation is optional if your disk has already been formatted.
To format the partition :
```bash
mkfs.ext4 /dev/YOUR_DISK
# then 'y' to validate
```
(Replace `YOUR_DISK` by the name of the disk. Be careful not to do any mistake here, as it can mean erasing data on your main system if you are using the wrong name ! In the previous example, the name of our disk was `sda`.)
Then, let's create a new partition on the disk which just got formatted :
First let's create a new partition on the disk :
```bash
fdisk /dev/YOUR_DISK
@ -64,6 +55,20 @@ then sucessfully type `n`, `p`, `1`, `Enter`, `Enter`, then `w` to create the ne
Check with `lsblk` that your disk really does contain a single partition.
Before you can use your disk it has to be formatted.
You should be aware that **formating a drive implies to erasing every data on it !** If your disk is already "clean", you may ignore this step.
To format the partition :
```bash
mkfs.ext4 /dev/YOUR_DISK1
# then 'y' to validate
```
(Replace `YOUR_DISK1` by the name of the first partition on the disk. Be careful not to do any mistake here, as it can mean erasing data on your main system if you are using the wrong name ! In the previous example, the name of our disk was `sda`.)
## 3. Mount the disk
"Mounting" a disk corresponds to making it effectively accessible in the filesystem tree. Here, we choose the arbitrary name `/media/storage` but you can choose a different name (for instance, `/media/my_disk` ... ).
@ -97,7 +102,7 @@ blkid | grep "/dev/YOUR_DISK1:"
```
Let's add a line in the file `/etc/fstab` which manages which disks are mounted at boot. We open this file with `nano` :
```bash
nano /etc/fstab
```

View file

@ -18,19 +18,19 @@ Vous devez également disposer d'un disque dur supplémentaire (branché en USB
Commencez par brancher ce disque dur à votre système. Il faut ensuite identifier sous quel nom est désigné le disque par le système.
Pour cela, utilisez la commande :
Pour cela, utilisez la commande :
```bash
lsblk
```
Elle peut renvoyer quelque chose comme :
Elle peut renvoyer quelque chose comme :
```bash
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sda 8:0 0 931.5G 0 disk
└─sda1 8:1 0 931.5G 0 part
mmcblk0 179:0 0 14.9G 0 disk
sda 8:0 0 931.5G 0 disk
└─sda1 8:1 0 931.5G 0 part
mmcblk0 179:0 0 14.9G 0 disk
├─mmcblk0p1 179:1 0 47.7M 0 part /boot
└─mmcblk0p2 179:2 0 14.8G 0 part /
```
@ -43,18 +43,9 @@ Ici, `mmcblk0` corresponds à une carte SD de 16Go (on voit que les partitions `
## 2. (Optionnel) Formater le disque
Si vous le souhaitez, vous pouvez formater votre disque avant de l'utiliser. Attention : **formatter un disque implique de supprimer toutes les données inscrites dessus !** Si votre disque est déjà "propre", vous pouvez passer cette étape.
Cette opération est optionnelle si votre disque est déjà formaté.
Pour formater la partition :
```bash
mkfs.ext4 /dev/VOTRE_DISQUE
# puis 'y' pour valider
```
(Remplacez `VOTRE_DISQUE` par le nom du disque. Attention à ne pas vous tromper de nom, car cela peut avoir pour conséquence de formatter un autre disque que celui voulu ! Dans l'exemple donné précédemment, il s'agissait de `sda`.)
Ensuite, créons une nouvelle partition sur le disque qui viens d'être formatté :
Créons une nouvelle partition sur le disque :
```bash
fdisk /dev/VOTRE_DISQUE
@ -64,16 +55,30 @@ puis entrez successivement `n`, `p`, `1`, `Entrée`, `Entrée`, et `w` pour cré
Vérifiez avec `lsblk` que vous avez bien votre disque contenant une seule partition.
Avant de pouvoir utiliser votre disque, il doit être formaté.
Attention : **formatter un disque implique de supprimer toutes les données inscrites dessus !** Si votre disque est déjà "propre", vous pouvez passer cette étape.
Pour formater la partition :
```bash
mkfs.ext4 /dev/VOTRE_DISQUE1
# puis 'y' pour valider
```
(Remplacez `VOTRE_DISQUE1` par le nom de la première partition sur le disque. Attention à ne pas vous tromper de nom, car cela peut avoir pour conséquence de formater un autre disque que celui voulu ! Dans l'exemple donné précédemment, il s'agissait de `sda`.)
## 3. Monter le disque
"Monter" un disque corresponds à le rendre effectivement accessible dans l'arborescence des fichiers. Nous allons choisir arbitrairement de monter le disque dans `/media/stockage` mais vous pouvez le nommer différement (par exemple `/media/mon_disque` ...).
Commençons par cŕeer le répertoire :
Commençons par cŕeer le répertoire :
```bash
mkdir /media/stockage
```
Puis nous pouvons monter le disque manuellement avec :
Puis nous pouvons monter le disque manuellement avec :
```bash
mount /dev/VOTRE_DISQUE1 /media/stockage
@ -87,7 +92,7 @@ Ensuite, vous devriez pouvoir créer des fichiers dans `/media/stockage`, et, pa
Jusqu'ici, nous avons monté manuellement le disque. Cependant, il peut être utile de configurer le système pour qu'il monte automatiquement le disque après un démarrage.
Pour commencer, trouvons l'UUID (identifiant universel) de notre disque avec :
Pour commencer, trouvons l'UUID (identifiant universel) de notre disque avec :
```bash
blkid | grep "/dev/VOTRE_DISQUE1:"
@ -96,12 +101,12 @@ blkid | grep "/dev/VOTRE_DISQUE1:"
```
Ajoutons alors une ligne au fichier `/etc/fstab` qui gère le montage des disques au démarrage. On ouvre donc le fichier avec `nano` :
```bash
nano /etc/fstab
```
Puis on ajoute cette ligne :
Puis on ajoute cette ligne :
```bash
UUID="cea0b7ae-2fbc-4f01-8884-3cb5884c8bb7" /media/stockage ext4 defaults,nofail 0 0

View file

@ -1,57 +1,32 @@
# Fail2ban
For a number of reasons, an IP adresse may be wrongly blacklisted. If you wish to access your server through this specify IP you will need to unblock it.
Fail2Ban is an intrusion prevention software that protects computer servers from brute-force attacks. It monitors some log files and will ban IP addresses that shows brute-force-like behavior.
## IP unblock
In particular, Fail2ban monitors SSH connection attempts. After 5 failed login attempts on SSH, Fail2ban will ban the corresponding IP address from connecting through SSH for 10 minutes. If this IP is found to recidive several times, it might get ban for a week.
First, list all iptables rules with: `iptables -L --line-numbers` :
## Unban an IP
To unban an IP from fail2ban, you first need to access your server by some mean (e.g. from another IP by the one being banned).
Then look at fail2ban's log to identify in which jail the IP was put :
```bash
root@beudi:~# iptables -L --line-numbers
Chain INPUT (policy ACCEPT)
num target prot opt source destination
1 fail2ban-yunohost tcp -- anywhere anywhere multiport dports http,https
2 fail2ban-nginx tcp -- anywhere anywhere multiport dports http,https
3 fail2ban-dovecot tcp -- anywhere anywhere multiport dports smtp,ssmtp,imap2,imap3,imaps,pop3,pop3s
4 fail2ban-sasl tcp -- anywhere anywhere multiport dports smtp,ssmtp,imap2,imap3,imaps,pop3,pop3s
5 fail2ban-ssh tcp -- anywhere anywhere multiport dports ssh
Chain FORWARD (policy ACCEPT)
num target prot opt source destination
Chain OUTPUT (policy ACCEPT)
num target prot opt source destination
Chain fail2ban-dovecot (1 references)
num target prot opt source destination
1 RETURN all -- anywhere anywhere
Chain fail2ban-nginx (1 references)
num target prot opt source destination
1 RETURN all -- anywhere anywhere
Chain fail2ban-sasl (1 references)
num target prot opt source destination
1 RETURN all -- anywhere anywhere
Chain fail2ban-ssh (1 references)
num target prot opt source destination
1 RETURN all -- anywhere anywhere
Chain fail2ban-yunohost (1 references)
num target prot opt source destination
1 DROP all -- 80.215.197.201 anywhere
2 RETURN all -- anywhere anywhere
$ tail /var/log/fail2ban.log
2019-01-07 16:24:47 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:49 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:51 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:54 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:57 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:57 fail2ban.actions [1837]: NOTICE [sshd] Ban 11.22.33.44
2019-01-07 16:24:57 fail2ban.filter [1837]: NOTICE [recidive] Ban 11.22.33.44
```
Here, Ip adress `80.215.197.201` is banned in the `fail2ban-yunohost` rule.
To unblock:
Here, the IP `11.22.33.44` was banned in the `sshd` and `recidive` jails.
Then unban the IP with the following commands :
```bash
iptables -D rule_name entry_number
$ fail2ban-client set sshd unbanip 11.22.33.44
$ fail2ban-client set recidive unbanip 11.22.33.44
```
For intance:
```bash
iptables -D fail2ban-yunohost 1
```

View file

@ -1,57 +1,32 @@
# Fail2ban
Pour diverses raisons, il peut arriver quune adresse IP ait été blacklistée. Si vous souhaitez accéder à votre serveur depuis cette IP, il faudra la débloquer.
Fail2Ban est un logiciel de prévention des intrusions qui protège les serveurs informatiques contre les attaques de brute-force. Il surveille certains journaux et bannira les adresses IP qui montrent un comportement de brute-forcing.
## Débloquer une IP
En particulier, Fail2ban surveille les tentatives de connexion SSH. Après 5 tentatives de connexion échouées sur SSH, Fail2ban banniera l'IP de se connecter via SSH pendant 10 minutes. Si cette adresse récidive plusieurs fois, elle peut être bannie pendant une semaine.
Tout dabord on affiche le listing de toutes les règles iptables avec la commande `iptables -L --line-numbers` :
## Débannir une IP
Pour débloquer une IP de fail2ban, vous devez d'abord accéder à votre serveur par un moyen quelconque (par exemple à partir d'une autre IP que celle bannie).
Ensuite, regardez le journal de fail2ban pour identifier dans quelle 'prison' (jail) l'IP a été bannie :
```bash
root@beudi:~# iptables -L --line-numbers
Chain INPUT (policy ACCEPT)
num target prot opt source destination
1 fail2ban-yunohost tcp -- anywhere anywhere multiport dports http,https
2 fail2ban-nginx tcp -- anywhere anywhere multiport dports http,https
3 fail2ban-dovecot tcp -- anywhere anywhere multiport dports smtp,ssmtp,imap2,imap3,imaps,pop3,pop3s
4 fail2ban-sasl tcp -- anywhere anywhere multiport dports smtp,ssmtp,imap2,imap3,imaps,pop3,pop3s
5 fail2ban-ssh tcp -- anywhere anywhere multiport dports ssh
Chain FORWARD (policy ACCEPT)
num target prot opt source destination
Chain OUTPUT (policy ACCEPT)
num target prot opt source destination
Chain fail2ban-dovecot (1 references)
num target prot opt source destination
1 RETURN all -- anywhere anywhere
Chain fail2ban-nginx (1 references)
num target prot opt source destination
1 RETURN all -- anywhere anywhere
Chain fail2ban-sasl (1 references)
num target prot opt source destination
1 RETURN all -- anywhere anywhere
Chain fail2ban-ssh (1 references)
num target prot opt source destination
1 RETURN all -- anywhere anywhere
Chain fail2ban-yunohost (1 references)
num target prot opt source destination
1 DROP all -- 80.215.197.201 anywhere
2 RETURN all -- anywhere anywhere
$ tail /var/log/fail2ban.log
2019-01-07 16:24:47 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:49 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:51 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:54 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:57 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
2019-01-07 16:24:57 fail2ban.actions [1837]: NOTICE [sshd] Ban 11.22.33.44
2019-01-07 16:24:57 fail2ban.filter [1837]: NOTICE [recidive] Ban 11.22.33.44
```
Il nous indique que lIP `80.215.197.201` est bannie dans la règle `fail2ban-yunohost`.
Pour la débloquer :
Ici, l'IP `11.22.33.44` a été bannie dans les jails `sshd` et `recidive`.
Puis débanissez l'IP avec les commandes suivantes :
```bash
iptables -D nom_de_la_regle numéro_de_l_entrée
$ fail2ban-client set sshd unbanip 11.22.33.44
$ fail2ban-client set recidive unbanip 11.22.33.44
```
Par exemple :
```bash
iptables -D fail2ban-yunohost 1
```

View file

@ -29,7 +29,7 @@ dans les faits, cest une « simple » sur-couche à Debian, qui gère les
manipulations pénibles à votre place.
Par exemple, pour installer un Wordpress à la main, il vous faudrait taper
toute une série de commande pour créer des utilisateurs, mettre en place un
toute une série de commandes pour créer des utilisateurs, mettre en place un
serveur web, mettre en place un serveur SQL, télécharger larchive de Wordpress,
la décompresser, configurer le serveur web, configurer la base de données SQL, et finalement configurer Wordpress. YunoHost gère toute cette partie technique et « tape les commandes à votre place », pour que vous puissiez vous concentrer sur ce qui compte vraiment.
@ -54,27 +54,27 @@ Pour des raisons techniques, le [SSO](https://github.com/YunoHost/SSOwat/) ne pe
#### Quel est le modèle économique de YunoHost ?
À lheure actuelle, YunoHost est maintenu uniquement par une équipe de bénévole
À lheure actuelle, YunoHost est maintenu uniquement par une équipe de bénévoles
travaillant pendant leur temps libre. Il ny a pas dargent impliqué dans le
projet (hormis quelques frais de serveurs et stickers :P).
Étant donné que certains contributeurs sont très engagés dans ce projet, nous réfléchissons à un moyen de rendre pérenniser le projet.
Étant donné que certains contributeurs sont très engagés dans ce projet, nous réfléchissons à un moyen de pérenniser le projet.
Il est question de financement par dons ou subventions, certains contributeurs mènent par ailleurs des activités professionnelles liées à YunoHost, .
Il est question de financement par dons ou subventions, certains contributeurs mènent par ailleurs des activités professionnelles liées à YunoHost.
#### Puis-je faire un don au projet ?
Oui, c'est possible ! YunoHost a besoin de payer des serveurs et noms de domaine, par ailleurs nous souhaiterions pouvoir permettre aux développeurs principaux de pouvoir continuer à développer YunoHost plutôt que de chercher des emplois ailleurs.
Oui, c'est possible ! YunoHost a besoin de payer des serveurs et noms de domaine, par ailleurs nous souhaiterions pouvoir permettre aux développeurs principaux de continuer à développer YunoHost plutôt que de chercher un emploi ailleurs.
Pour donner ça se passe via notre [Liberapay](https://liberapay.com/YunoHost)
Pour faire un don ça se passe via notre [Liberapay](https://liberapay.com/YunoHost)
Si vous le pouvez, vous pouvez aussi faire des contributions en nature (une partie de notre infrastructure viens d'association qui nous fournissent des serveurs).
Si vous le pouvez, vous pouvez aussi faire des contributions en nature (une partie de notre infrastructure vient d'associations qui nous fournissent des serveurs).
#### Comment puis-je contribuer au projet ?
Il y existe [plusieurs façons de contribuer](contribute) :).
Il existe [plusieurs façons de contribuer](contribute) :).
Nhésitez pas à venir nous parler de vos idées!
@ -100,7 +100,7 @@ Réponse courte : non. Léquipe na pas lénergie et ce nest pas pert
<div id="willyouportyunohost" class="collapse">
<p>Si vous vous préoccupez des guéguerres de distro, ou pensez que « Debian cest sale », vous nêtes pas le public de YunoHost.</p>
<p>YunoHost vise un public de non-technophile ou de bidouilleurs qui veulent simplement que le serveur fonctionne sans devoir investir des semaines entières. Debian a probablement des défauts, mais cest une (la ?) distribution la plus connue et utilisée pour gérer des serveurs. Cest une distribution stable. La plupart des services auto-hébergeables sont compatibles dune manière ou dune autre avec Debian. Elle est facilement bidouillable par quelquun qui a déjà utilisé la ligne de commande sur son ordinateur personnel. Il ny a pas de « killer feature » particulière dans les autres distributions qui rendrait pertinent de porter YunoHost dessus.</p>
<p>YunoHost vise un public de non-technophiles ou de bidouilleurs qui veulent simplement que le serveur fonctionne sans devoir investir des semaines entières. Debian a probablement des défauts, mais cest une (la ?) distribution la plus connue et utilisée pour gérer des serveurs. Cest une distribution stable. La plupart des services auto-hébergeables sont compatibles dune manière ou dune autre avec Debian. Elle est facilement bidouillable par quelquun qui a déjà utilisé la ligne de commande sur son ordinateur personnel. Il ny a pas de « killer feature » particulière dans les autres distributions qui rendrait pertinent de porter YunoHost dessus.</p>
<p>Si cela ne vous convient pas, il existe dautres projets sous dautres distributions ou avec dautres philosophies.</p>
</div>
@ -118,7 +118,7 @@ Réponse moyenne : Par le passé, les apps étaient gérées via des .deb. C
<p>Il se trouve que lobjectif des paquets dapplication YunoHost est subtilement différent des paquets traditionnels (comme les .deb de Debian) qui remplissent le rôle dinstaller des éléments bas-niveaux tels que des fichiers, commandes, programmes ou services sur le système. Il est à la charge de ladministrateur de les configurer ensuite proprement, simplement parce quil nexiste pas denvironnement standard. Typiquement, les applications web requièrent beaucoup de configuration car elles ont besoin de sinterfacer avec un serveur web et une base de données (et le système de connexion unique / SSO).</p>
<p>YunoHost manipule des abstractions haut-niveau (apps, domaines, utilisateurs…) et défini un environnement standard (Nginx, Postfix, Metronome, SSOwat…) et, grâce à cela, peut gérer la configuration à la place de ladministrateur.</p>
<p>YunoHost manipule des abstractions haut-niveau (apps, domaines, utilisateurs…) et définit un environnement standard (Nginx, Postfix, Metronome, SSOwat…) et, grâce à cela, peut gérer la configuration à la place de ladministrateur.</p>
<p>Si vous restez persuadé que lon peut néanmoins bricoler les paquets .deb pour gérer tout cela, voir les réponses précédentes.</p>
</div>

85
filezilla.md Normal file
View file

@ -0,0 +1,85 @@
# 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.
This is an alternative to using `scp` which can be deemed technical and cryptic,
or using an app like Nextcloud.
[FileZilla](https://filezilla-project.org/) can be used for this. It is a free
software and is available for Windows, Linux and macOS.
## Download and install FileZilla
Get the client from the [download page](https://filezilla-project.org/download.php?type=client). It should automatically detect the version needed for your computer. Otherwise, follow the instructions to [install the client](https://wiki.filezilla-project.org/Client_Installation)
Install the program and run *Filezilla*.
## Configuration
1. Click the *Site Manager* icon in the upper left to begin.
![Main screen of Filezilla](images/filezilla_1.png)
2. Click **New Site** and give a name the server you will be using : *Family* here. Fill the settings as on the screenshot (replace the server adress with your own), and click on **Connect**. (N.B. : if you want to interact with the [custom webapp](https://github.com/YunoHost-Apps/my_webapp_ynh) files, you should use a different user than `admin`. Refer to the custom webapp documentation.)
![Site manager screen](images/filezilla_2.png)
3. You will get a warning as you connect for the first time to the server. *You can ignore it safely the first time you get it.*
![warning about the unknown fingerprint of the server](images/filezilla_3.png)
4. Filezilla is now asking the `admin` password to connect to your server.
![credential screen asking for the password](images/filezilla_4.png)
5. Once bookmarked, your server will be backup up and you will get this screen.
![View of the "site manager" with the newly server added](images/filezilla_5.png)
<div class="alert alert-success">
<span class="glyphicon glyphicon-chevron-right"></span> You can now use your new bookmark to connect to the server
</div>
## Usage
1. Connect to the Site created previously. *Your passwork might be asked again*
The left panel corresponds to your computer. The right panel corresponds to your remote Yunohost server. You can browse folders and drag-and-drop files between the two panels.
![view while connected to a remote server](images/filezilla_6.png)
2. In the right panel, you can browse to `/home/yunohost.backup/archives/` to find [backup archives](/backup).
![path where backups are located on Yunohost](images/filezilla_7.png)
<div class="alert alert-warning">
<span class="glyphicon glyphicon-cloud-download"></span> Be sure to download both the `.tar.gz` and `.json` files.
</div>
![Copy backups from Yunohost to local computer](images/filezilla_8.png)
----
Sources
* [Official documentation](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(en))
* [General tutorial about using FileZilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
## Alternatives to Filezilla
### Linux
From any recent Linux, you should be able to use the `file manager` to reach your server.
Nautilus from Gnome3 has features similar to FileZilla, out of the box.
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
### Windows
* [WinSCP](https://winscp.net/) is also a nice candidate for Windows
### MacOS
Feel free to complete this part

87
filezilla_fr.md Normal file
View file

@ -0,0 +1,87 @@
# É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
une méthode alternative au fait d'utiliser la commande `scp` qui peut être jugée
technique et cryptique, ou de devoir installer Nextcloud.
[FileZilla](https://filezilla-project.org/) permet d'accomplir cela. Il s'agit
d'un logiciel libre disponible pour Windows, Linux et MacOS.
## Télécharger et installer FileZilla
Vous pouvez télécharger FileZilla depuis [cette page](https://filezilla-project.org/download.php?type=client).
Le site devrait détecter automatiquement la version nécessaire pour votre ordinateur.
Sinon, suivez les instructions pour [installer le client](https://wiki.filezilla-project.org/Client_Installation)
Installez le programme et lancez *Filezilla*.
## Configuration
1. Cliquez sur l'icône *Gestionnaire de Sites* en haut à gauche de sorte à crééer une configuration utilisable ultérieurement.
![écran principal de Filezilla](images/filezilla_1.png)
2. Cliquez sur **Nouveau site** et donnez un nom au serveur que vous allez utiliser. Par exemple "Famille". Remplissez les paramètres comme sur la capture d'écran (en remplaçant l'adresse du serveur par la votre). Une fois terminé, cliquez sur **Connexion**. (N.B. : si vous souhaitez éditer les fichiers de l'application [custom webapp](https://github.com/YunoHost-Apps/my_webapp_ynh), il vous faudra utiliser un autre utilisateur que admin. Se référer à la documentation de custom webapp.)
![écran du gestionnaire de site](images/filezilla_2.png)
3. Vous recevrez un avertissement. *Vous pouvez l'ignorer si il s'agit de la première connexion*.
![avertissement au sujet de l'empreinte inconnue du serveur](images/filezilla_3.png)
4. Filezilla vous demande maintenant le mot de passe `admin` pour vous connecter à votre serveur
![écran d'identification demandant le mot de passe](images/filezilla_4.png)
5. Une fois cette configuration créée, elle sera réutilisable les fois suivanteS.
![la vue du "gestionnaire de site" avec le nouveau serveur ajouté](images/filezilla_5.png)
<div class="alert alert-success">
<span class="glyphicon glyphicon-chevron-right"></span> Vous pouvez désormais utiliser cette configuration pour vous connecter.
</div>
## Utilisation
1. Connectez-vous au Site créé précédemment. *Il se peut que le mot de passe soit redemandé.*
La partie gauche correspond à votre ordinateur. La partie droite correspond au serveur YunoHost distant. Vous pouvez naviguer dans les dossiers et faire des glisser-déposer entre les deux panneaux.
![la vue pendant la connexion à un serveur distant](images/filezilla_6.png)
2. Dans le panneau de droite, vous pouvez aller dans `/home/yunohost.backup/archives/` pour trouver les archives de [sauvegardes](/backup_fr).
![le chemin où les sauvegardes sont situées sur Yunohost](images/filezilla_7.png)
<div class="alert alert-warning">
<span class="glyphicon glyphicon-cloud-download"></span> Assurez-vous de télécharger à la fois le fichier `.tar.gz` et le fichier `.json`
</div>
![Copier les sauvegardes de Yunohost sur l'ordinateur local](images/filezilla_8.png)
----
Sources
* [Documentation officielle](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(fr))
* [Tutoriel général à Filezilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
## Alternatives à Filezilla
### Sous Linux
Depuis n'importe quel Linux récent, vous devriez pouvoir utiliser le gestionnaire de fichiers pour accéder à votre serveur.
Nautilus de Gnome3 intègre de base des fonctionnalités similaires à FileZilla :
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
### Sous Windows
* [WinSCP](https://winscp.net/) est aussi un bon candidat pour Windows
### Sous MacOS
N'hésitez pas à compléter cette partie

View file

@ -32,7 +32,7 @@ Please don't do this. Reinstalling is a heavy operation and is not a good long-t
## 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)
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

View file

@ -1,21 +1,14 @@
# Hardware
YunoHost is compatible with most of the hardware.
Before proceeding to the installation it is important to identify the model of your computer.
YunoHost can be installed on the following hardware :
- ARM boards (Raspberry Pi, Olinuxino LIME1 & 2, Orange Pi, etc...) ;
- 'Old' desktop computers or laptops ;
- Remote servers, a.k.a Virtual Private Servers (VPS).
*Click on your hardware's guide.*
| Arch | Hardware examples | Installation guide |
|------|-----------------------|----------------------|
| **x86** | Desktops, Laptops, Intel Mac (after 2007), netbooks, nettops, etc. | [Install via CD/USB](/install_iso) |
| **armhf** | [ARM board](install_on_arm_board), [Raspberry Pi](/install_on_raspberry), Cubox, Olimex, Beagleboard, etc. | [Install on ARM Debian](/install_on_debian) |
Corresponding installation guides can be found on [this page](/install).
### Minimum requirements
- 500MHz CPU
* 256MB RAM
* 4GB storage capacity
### Recommended
* Recent x86 computer, silent and low consumption.
* 512MB RAM in order to run all the services and apps properly
* 20GB storage in order to store more mails and documents
* 500 MHz CPU
* 512 MB RAM (recommended : 1 GB in order to run all the services and apps properly)
* 8 GB storage capacity (recommended : 32 GB to store mails and documents)

View file

@ -1,21 +1,14 @@
# Matériel
YunoHost est compatible avec tous les types de machines courantes.
Il est important didentifier votre type de machine avant de procéder à linstallation.
YunoHost peut être installé sur les types de matériel suivant :
- Cartes ARM (Raspberry Pi, Olinuxino LIME1 & 2, Orange Pi, etc...) ;
- 'Vieux' ordinateurs de bureau ou portables ;
- Serveurs distants, aussi appelé Virtual Private Servers (VPS).
*Cliquez sur le guide correspondant à votre matériel.*
| Type | Exemples de machines | Guide dinstallation |
|------|-----------------------|----------------------|
| **x86** | PC de bureau, PC portables, Mac Intel (après 2007), netbooks, nettops, etc. | [Installation via CD/USB](/install_iso_fr) |
| **armhf** | [Carte ARM](install_on_arm_board_fr), [Raspberry Pi](/install_on_raspberry_fr), Olimex, Cubox, Beagleboard, etc… | [Installation sur Debian ARM](/install_on_debian_fr) |
Les guides d'installations peuvent être trouvés sur [cette page](/install_fr).
### Configuration minimale
- 500 MHz de processeur
* 256 Mo de RAM
* 4 Go despace de stockage
### Configuration recommandée
* Machine x86 récente, silencieuse et peu consommatrice.
* 512 Mo de RAM, pour pouvoir faire tourner tous les services et applications correctement
* 20 Go despace de stockage, pour pouvoir stocker plus demails et de documents
* Processeur 500MHz
* 512 Mo de RAM (recommandée : 1Go pour pouvoir faire tourner les services et applications correctement)
* 8 Go d'espace de stockage (recommandé : 32 Go pour pouvoir stocker emails et documents)

View file

@ -10,11 +10,11 @@
</ul>
</div>
<iframe src="https://kiwiirc.com/client/irc.freenode.org/?nick=foobar|?&theme=mini#yunohost" style="border:0; width:100%; height:450px;"></iframe>
<iframe src="https://kiwiirc.com/client/irc.freenode.org:+6697/?nick=foobar|?&theme=mini#yunohost" style="border:0; width:100%; height:450px;"></iframe>
</br>
</br>
<em>Note : this room is available via IRC (#yunohost on freenode - <a href="https://kiwiirc.com/client/irc.freenode.org/?nick=foobar|?&theme=mini#yunohost">using kiwiirc</a>), via XMPP <small>(support@conference.yunohost.org)</small>, or Matrix <small>(#freenode_#yunohost:matrix.org - <a target="_blank" href="https://riot.im/app/#/room/#yunohost:matrix.org">using Riot</a>)</small></em>
<em>Note : this room is available via IRC (#yunohost on freenode - <a href="https://kiwiirc.com/client/irc.freenode.org:+6697/?nick=foobar|?&theme=mini#yunohost">using kiwiirc</a>), via XMPP <small>(support@conference.yunohost.org)</small>, or Matrix <small>(#freenode_#yunohost:matrix.org - <a target="_blank" href="https://riot.im/app/#/room/#yunohost:matrix.org">using Riot</a>)</small></em>
</center>
<h3>... or ask on the forum !</h3>

View file

@ -12,14 +12,14 @@
<div dir="rtl"><strong>الإسم المستعار</strong> : <input id="nickname" value="foobar__" type="text">
</div>
<iframe src="https://kiwiirc.com/client/irc.freenode.org/?nick=foobar|?&theme=mini#yunohost" style="border:0; width:100%; height:450px;"></iframe>
<iframe src="https://kiwiirc.com/client/irc.freenode.org:+6697/?nick=foobar|?&theme=mini#yunohost" style="border:0; width:100%; height:450px;"></iframe>
</br>
</br>
<div dir="rtl">
<em>ملاحظة : يمكن الإتصال كذلك بغرفة المحادثة باستخدام تطبيق XMPP الخاص بك على العنوان التالي </br>
support@conference.yunohost.org </br>
<a target="_blank" href="https://kiwiirc.com/client/irc.freenode.org/?nick=foobar|?&theme=mini#yunohost">kiwiirc</a> باستخدام freenode على #yunohost IRC أو </br>
<a target="_blank" href="https://kiwiirc.com/client/irc.freenode.org:+6697/?nick=foobar|?&theme=mini#yunohost">kiwiirc</a> باستخدام freenode على #yunohost IRC أو </br>
<a target="_blank" href="https://riot.im/app/#/room/#yunohost:matrix.org">Riot</a> باستخدام Matrix أو </br>
</em>
</div>

View file

@ -10,13 +10,11 @@
</ul>
</div>
<iframe
src="https://kiwiirc.com/client/irc.freenode.org/?nick=foobar|?&theme=mini#yunohost"
style="border:0; width:100%; height:450px;"></iframe>
<iframe src="https://kiwiirc.com/client/irc.freenode.org:+6697/?nick=foobar|?&theme=mini#yunohost" style="border:0; width:100%; height:450px;"></iframe>
</br>
</br>
<em>Note : ce salon est accessible via IRC (#yunohost sur freenode en utilisant <a href="https://kiwiirc.com/client/irc.freenode.org/?nick=foobar|?&theme=mini#yunohost">Kiwiirc</a>), via XMPP <small>(support@conference.yunohost.org)</small>, ou Matrix <small>(#freenode_#yunohost:matrix.org - <a target="_blank" href="https://riot.im/app/#/room/#yunohost:matrix.org">en utilisant Riot</a>)</small>.</em>
<em>Note : ce salon est accessible via IRC (#yunohost sur freenode en utilisant <a href="https://kiwiirc.com/client/irc.freenode.org:+6697/?nick=foobar|?&theme=mini#yunohost">Kiwiirc</a>), via XMPP <small>(support@conference.yunohost.org)</small>, ou Matrix <small>(#freenode_#yunohost:matrix.org - <a target="_blank" href="https://riot.im/app/#/room/#yunohost:matrix.org">en utilisant Riot</a>)</small>.</em>
</center>
<h3>... ou demandez sur le forum !</h3>

57
help_it.md Normal file
View file

@ -0,0 +1,57 @@
# Cerchi aiuto?
<h3>Connettiti alla chat di supporto</h3>
<center>
<div class="alert alert-info" markdown="1" style="max-width:700px;">
<strong>ProTips™</strong>
<ul style="text-align:left;">
<li>Non chiedere tanto per chiedere, chiedi e basta !</li>
<li><em>Sii paziente</em>, potrebbero servire alcuni minuti prima che qualcuno veda i tuoi messaggi.</li>
</ul>
</div>
<iframe src="https://kiwiirc.com/client/irc.freenode.org:+6697/?nick=foobar|?&theme=mini#yunohost" style="border:0; width:100%; height:450px;"></iframe>
</br>
</br>
<em>Nota : questa stanza e disponibile via IRC (#yunohost su freenode - <a href="https://kiwiirc.com/client/irc.freenode.org:+6697/?nick=foobar|?&theme=mini#yunohost">usando kiwiirc</a>), via XMPP <small>(support@conference.yunohost.org)</small>, o Matrix <small>(#freenode_#yunohost:matrix.org - <a target="_blank" href="https://riot.im/app/#/room/#yunohost:matrix.org">usando Riot</a>)</small></em>
</center>
<h3>... o chiedi nel forum !</h3>
<center>
<button id="goForum" type="button" class="btn btn-success" style="font-weight:bold;">
<span class="glyphicon glyphicon-comment"></span> Vai al forum
</button>
</center>
<h3>Hai trovato un problema ?</h3>
<center>
<br>
<em>Per favore segnalalo nel nostro bugtracker o contatta gli sviluppatori</em><br><br>
<button id="goBugtracker" type="button" class="btn btn-warning" style="font-weight:bold;">
<span class="glyphicon glyphicon-exclamation-sign"></span> Segnala un bug
</button>
<button id="goDevroom" type="button" class="btn btn-warning" style="font-weight:bold; margin-left:40px">
<span class="glyphicon glyphicon-comment"></span> Contatta gli sviluppatori
</button>
</br>
</br>
<em>Nota : puoi anche connetterti alla stanza degli sviluppatori, utilizzando il tuo client XMPP preferito, su </br>
dev@conference.yunohost.org e apps@conference.yunohost.org</em>
</center>
<script>
document.getElementById("goForum").onclick = function() {
window.location.href = "https://forum.yunohost.org/latest";
}
document.getElementById("goBugtracker").onclick = function() {
window.location.href = "https://github.com/yunohost/issues/issues";
}
document.getElementById("goDevroom").onclick = function() {
window.location.href = "https://kiwiirc.com/client/irc.freenode.net/yunohost-dev";
}
</script>

View file

@ -1,27 +1,27 @@
# 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 :
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.
You can host yourself at home with an ARM board or a re-purposed regular computer, connected to your home router/box.
- **Pros** : you will have physical control on the machine and only need to buy the hardware ;
- **Pros** : you will have physical control of the machine and only need to buy the hardware;
- **Cons** : you will have to [manually configure your internet box](isp_box_config) and [might be limited by your ISP](isp).
### 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/).
A VPN is an encrypted tunnel between two machines. In practice, it makes it "as if" you were directly, locally, connected to your server machine, but actually from somewhere else on the Internet. This allows you to still host yourself at home, while bypassing possible limitations of 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 ;
- **Pros** : you will have physical control of the machine, and the VPN hides your traffic from your ISP and allows you 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.
You can rent a virtual private server or a dedicated machine from [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.
- **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 of your server.
### Summary
@ -42,12 +42,12 @@ You can rent a virtual private server or a dedicated machine to [associative](ht
</tr>
<tr>
<td style="text-align:center;">Monthly cost</td>
<td style="text-align:center;" class="success">Neglictible<br><small>(electricity)</small></td>
<td style="text-align:center;" class="success">Negligible<br><small>(electricity)</small></td>
<td style="text-align:center;" class="warning">Around 5€ <br><small>(VPN)</small></td>
<td style="text-align:center;" class="warning">Starting at ~3€ <br><small>(VPS)</small></td>
</tr>
<tr>
<td style="text-align:center;">Physical control<br>on the machine</td>
<td style="text-align:center;">Physical control<br>of the machine</td>
<td style="text-align:center;" class="success">Yes</td>
<td style="text-align:center;" class="success">Yes</td>
<td style="text-align:center;" class="danger">No</td>
@ -71,12 +71,12 @@ You can rent a virtual private server or a dedicated machine to [associative](ht
</tr>
<tr>
<td style="text-align:center;">RAM</td>
<td style="text-align:center;" class="warning" colspan="2">Typically 500 Mo or 1 Go</td>
<td style="text-align:center;" class="warning" colspan="2">Typically 500 Mb or 1 Gb</td>
<td style="text-align:center;" class="warning">Related to server cost</td>
</tr>
<tr>
<td style="text-align:center;">Internet connectivity</td>
<td style="text-align:center;" class="warning" colspan="2">Depends of home connectivity</td>
<td style="text-align:center;" class="warning" colspan="2">Depends on home connectivity</td>
<td style="text-align:center;" class="success">Typically pretty good</td>
</tr>
</tbody>

View file

@ -4,14 +4,14 @@ Vous pouvez vous auto-héberger à la maison (sur un petit ordinateur), ou sur u
### À 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.
Vous pouvez vous héberger chez vous, sur une carte ARM ou un vieil ordinateur, connecté à votre box internet.
- **Avantages** : vous aurez un contrôle physique sur la machine et avez seulement besoin d'acheter le matériel initial ;
- **Inconvénients** : il vous faudra [configuré manuellement votre box internet](isp_box_config) et serez possiblement [limité par certains aspects de votre fournisseur d'accès internet](isp).
- **Inconvénients** : il vous faudra [configurer manuellement votre box internet](isp_box_config) et serez possiblement [limité par certains aspects de votre fournisseur d'accès internet](isp).
### À la maison, derrière un VPN
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/).
Un VPN est un tunnel chiffré entre deux machines. En pratique, cela permet de faire "comme si" une machine était connectée 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.

View file

@ -1,5 +1,11 @@
# Pre-installed images
<span class="javascriptDisclaimer">
This page requires Javascript enabled to display properly :s.
<br/>
<br/>
</span>
<div id="cards-list">
</div>

BIN
images/Mediawiki_logo.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 184 KiB

BIN
images/PluXml_logo.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

View file

Before

Width:  |  Height:  |  Size: 46 KiB

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

BIN
images/filezilla_1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

BIN
images/filezilla_2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

BIN
images/filezilla_3.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

BIN
images/filezilla_4.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.2 KiB

BIN
images/filezilla_5.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

BIN
images/filezilla_6.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

BIN
images/filezilla_7.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

BIN
images/filezilla_8.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

115
images_ar.md Normal file
View file

@ -0,0 +1,115 @@
# الصور
<div id="cards-list">
</div>
<script type="text/template" id="image-template">
<div id="{id}" class="card panel panel-default">
<div class="panel-body text-center">
<h3>{name}</h3>
<div class="card-comment">{comment}</div>
<div class="card-desc text-center">
<img src="/images/{image}" height=100 style="vertical-align:middle">
</div>
</div>
<div class="annotations">
<div class="col-sm-6 annotation"><a href="{file}.sha256sum"><span class="glyphicon glyphicon-barcode" aria-hidden="true"></span> Checksum</a></div>
<div class="col-sm-6 annotation"><a href="{file}.sig"><span class="glyphicon glyphicon-tag" aria-hidden="true"></span> Signature</a></div>
</div>
<div class="btn-group" role="group">
<a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> تنزيل <small>{version}</small></a>
</div>
</div>
</script>
<style>
/*
###############################################################################
Style sheet for the cards
###############################################################################
*/
#cards-list:after {
content:'';
display:block;
clear: both;
}
.card {
margin-bottom:20px;
width:270px;
float:left;
min-height: 1px;
margin-right: 10px;
margin-left: 10px;
}
.card .panel-body > h3 {
margin-top:0;
margin-bottom:5px;
font-size:1.2em;
}
.card-desc {
height:100px;
overflow: hidden;
}
.card .btn-group {
width:100%;
margin-left: 0px;
}
.card > .btn-group > .btn{
border-bottom:0;
}
.card > .btn-group {
border-left:0;
border-top-left-radius:0;
border-top-right-radius:0;
margin-left: 0px;
}
.card-comment {
font-size: 0.8em;
margin-top:-5px;
}
.card > .annotations {
text-align:center;
font-size:small;
}
</style>
<script>
/*
###############################################################################
Script that loads the infos from javascript and creates the corresponding
cards
###############################################################################
*/
$(document).ready(function () {
console.log("in load");
$.getJSON('https://build.yunohost.org/images.json', function (images) {
$.each(images, function(k, infos) {
// Fill the template
html = $('#image-template').html()
.replace('{id}', infos.id)
.replace('{name}', infos.name)
.replace('{comment}', infos.comment || "&nbsp;")
.replace('{image}', infos.image)
.replace('{version}', infos.version);
if (infos.file.startsWith("http"))
html = html.replace(/{file}/g, infos.file);
else
html = html.replace(/{file}/g, "https://build.yunohost.org/"+infos.file);
if ((typeof(infos.has_sig_and_sums) !== 'undefined') && infos.has_sig_and_sums == false)
{
var $html = $(html);
$html.find(".annotations").html("&nbsp;");
html = $html[0];
}
$('#cards-list').append(html);
});
});
});
</script>

View file

@ -1,5 +1,12 @@
# Images
<span class="javascriptDisclaimer">
Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
<br/>
<br/>
</span>
<div id="cards-list">
</div>

View file

@ -6,17 +6,16 @@
<div class="punchline">
<p>
<span class="yolo 1" style="color: #FF3399;">Self-hosting for you, mom</span>
<span class="yolo 2" style="color: #6699FF;">Haters gonna host</span>
<span class="yolo 3" style="color: #66FF33;">I host myself, Yo!</span>
<span class="yolo 4" style="color: #00FFCC;">Go host yourself!</span>
<span class="yolo 5" style="color: #FF5050;">Get off of my cloud</span>
<span class="yolo 6" style="color: #FF0066;">Host me Im famous</span>
<span class="yolo 7" style="color: #3366FF;">Try Internet</span>
<span class="yolo 8" style="color: #FFFFFF;">How I met your server</span>
<span class="yolo 9" style="color: #FF6600;">john@doe.org</span>
<span class="yolo 10" style="color: #FF5050;">dude, Y U NO Host?!</span>
<span class="yolo 11" style="color: #66FF33;">Keep calm and host yourself</span>
<span class="yolo 1" style="color: #6699FF;">Haters gonna host</span>
<span class="yolo 2" style="color: #66FF33;">I host myself, Yo!</span>
<span class="yolo 3" style="color: #00FFCC;">Go host yourself!</span>
<span class="yolo 4" style="color: #FF5050;">Get off of my cloud</span>
<span class="yolo 5" style="color: #FF0066;">Host me Im famous</span>
<span class="yolo 6" style="color: #3366FF;">Try Internet</span>
<span class="yolo 7" style="color: #FFFFFF;">How I met your server</span>
<span class="yolo 8" style="color: #FF6600;">john@doe.org</span>
<span class="yolo 9" style="color: #FF5050;">dude, Y U NO Host?!</span>
<span class="yolo 10" style="color: #66FF33;">Keep calm and host yourself</span>
</p>
<button class="btn btn-primary btn-lg btn-block yolobtn">What?</button>
</div>
@ -44,7 +43,7 @@
<div class="call-to-action">
<a class="btn btn-primary btn-lg" href="/try">Try it</a>
<a class="btn btn-success btn-lg" href="/install">Get started</a>
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-2-release-sortie-de-yunohost-3-2/5710">YunoHost v3.2</a></small></p>
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-4-release-sortie-de-yunohost-3-4/6950">YunoHost v3.4</a></small></p>
</div>
<div class="row cf">

View file

@ -40,7 +40,7 @@
<div dir="auto" class="call-to-action">
<a class="btn btn-primary btn-lg" href="/try">تجريب</a>
<a class="btn btn-success btn-lg" href="/install">تنصيب</a>
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-2-release-sortie-de-yunohost-3-2/5710">YunoHost v3.2</a></small></p>
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-4-release-sortie-de-yunohost-3-4/6950">YunoHost v3.4</a></small></p>
</div>
<hr />

View file

@ -18,7 +18,7 @@
<span class="yolo 10" style="color: #FF5050;">dude, Y U NO Host?!</span>
<span class="yolo 11" style="color: #66FF33;">Ruhe bewahren und sich selbst bewirten</span>
</p>
<button class="btn btn-primary btn-lg btn-block yolobtn">Entschuldigung?</button>
<button class="btn btn-primary btn-lg btn-block yolobtn">Wie bitte?</button>
</div>
<div class="main-links hidden-xs">
@ -34,22 +34,23 @@
<img src="/images/github_ribbon_grey.png" alt="Folgen Sie Yunohost auf GitHub">
</a>
<h1>YunoHost <small>ist ein Serverbetriebssystem mit dem Ziel, Self-Hosting für jedermann zugänglich zu machen.</small></h1>
<h1>YunoHost <small>ist ein Serverbetriebssystem mit dem Ziel,<br>
Self-Hosting für jedermann zugänglich zu machen.</small></h1>
<div class="home-panel">
<img src="/images/home_panel.jpg" />
</div>
<div class="call-to-action">
<a class="btn btn-primary btn-lg" href="/try">Try it</a>
<a class="btn btn-success btn-lg" href="/install">Get started</a>
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-2-release-sortie-de-yunohost-3-2/5710">YunoHost v3.2</a></small></p>
<a class="btn btn-primary btn-lg" href="/try">Ausprobieren</a>
<a class="btn btn-success btn-lg" href="/install">Beginnen</a>
<p class="text-muted"><small><a href="https://forum.yunohost.org/t/yunohost-3-4-release-sortie-de-yunohost-3-4/6950">YunoHost v3.4</a></small></p>
</div>
<div class="row cf">
<div class="col-md-7">
<h1>Installieren<small> Sie eure Server mit Leichtigkeit, Sie haben bereits alles zu Hause.</small></h1>
<p><br /><a href="/hardware">Siehe die Voraussetzungen.</a></p>
<h1>Installieren<small> Sie ganz einfach Ihren eigenen Server. Sie haben bereits alles, was Sie brauchen.</small></h1>
<p><br /><a href="/hardware">Hardware-Voraussetzungen</a></p>
</div>
<div class="col-md-4">
<div class="feature-pic">
@ -67,7 +68,7 @@
</div>
</div>
<div class="col-md-7 text-right">
<h1>Genießen <small>Sie Ihre Apps und machen Sie Ihre kleine Ecke von Internet</small></h1>
<h1>Erfreuen <small>Sie sich an Ihren eigenen Apps und richten Sie ihre eigene kleine Ecke im Netz ein.</small></h1>
<p><br /><a href="/apps">Liste der verfügbaren Apps</a></p>
</div>
</div>
@ -76,8 +77,8 @@
<div class="row cf">
<div class="col-md-7">
<h1>Verwalten <small>Sie Ihren Server so, wie Sie es wünschen: per Web, Handy oder Kommandozeile.</small></h1>
<p><br /><a href="/try">Testen Sie die Administrationsoberfläche</a></p>
<h1>Verwalten <small>Sie Ihren Server so, wie Sie es wünschen: per Web, mobil oder mit der Kommandozeile.</small></h1>
<p><br /><a href="/try">Administrationsoberfläche testen</a></p>
</div>
<div class="col-md-4">
<div class="feature-pic">
@ -99,7 +100,7 @@
<a class="btn btn-lg btn-block btn-danger btn-support" href="/help_de">Support</a>
</div>
<div class="col-md-7 text-right">
<h1>Erfahren <small>Sie, was Sie mit einem Server machen können und warum es wichtig ist.</small></h1>
<h1>Erfahren <small>Sie, was Sie mit einem Server machen können,<br> und warum es sinnvoll ist.</small></h1>
<p><br /><a href="/docs">Lesen Sie die Dokumentation</a></p>
</div>
</div>
@ -107,7 +108,7 @@
<hr />
<div class="text-center">
<h1>Hey! Wir sind Menschen!<br /><small> Wenn Sie eine Frage oder ein Problem haben oder wenn Sie nur ein Enthusiast sind, hinterlassen Sie eine Nachricht in unserem Chatraum, indem Sie auf den untenstehenden Button klicken.&nbsp;<span class="glyphicon glyphicon-share-alt"></span> </small></h1>
<h1>Hey! Wir sind Menschen.<br /><small> Wenn Sie eine Frage oder ein Problem haben oder wenn Sie auch nur neugierig sind, hinterlassen Sie gerne eine Nachricht in unserem Chatraum, indem Sie auf den untenstehenden Button klicken.&nbsp;<span class="glyphicon glyphicon-share-alt"></span> </small></h1>
<p class="liberapay">
<a href="https://liberapay.com/YunoHost" target="_blank"><img src="/images/liberapay_logo.svg" alt="Donation button" title="Liberapay" /></a>

Some files were not shown because too many files have changed in this diff Show more