mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Merge pull request #740 from YunoHost/stretch
Update documentation according to changes in Stretch
This commit is contained in:
Alexandre Aubin
GitHub
commit
39809a9ffc
58 changed files with 518 additions and 451 deletions
284
backup.md
284
backup.md
|
|
@ -1,165 +1,149 @@
|
|||
# Backup
|
||||
Backing up your server and apps
|
||||
===============================
|
||||
|
||||
First make sure that the `archives` folder exists in `/home/yunohost.backup/`. If it does not, create it with:
|
||||
Backing up your server, apps and data is an important concern when administrating a server. This protects you from unexpected events that could happen (server lost in a fire, database corruption, loss of access, server compromised, ...). The backup policy you will put in place depends of the importance of the services and data hosted. For instance you won't care too much about having backup on a test server, but you will care about having a backup of critical data of your association or company, and having this backup *in a different physical place*.
|
||||
|
||||
Backups in the context of YunoHost
|
||||
----------------------------------
|
||||
|
||||
YunoHost comes with a backup system, that allows to backup (and restore) system configurations and data (e.g. mails) and apps if they support it.
|
||||
|
||||
You can manage backups either from the command line (`yunohost backup --help`) or from the web administration (in the Backups section) though some features are not yet available in the webadmin.
|
||||
|
||||
The current default method consists in creating a `.tar.gz` archive containing all relevant files. In the future, YunoHost plans to support [Borg](https://www.borgbackup.org/) which is a more flexible, efficient and powerful solution.
|
||||
|
||||
Creating backups
|
||||
----------------
|
||||
|
||||
#### From the webadmin
|
||||
|
||||
You can easily create backup archives from the webadmin by going in Backups > Local storage and clicking on "New backup". You will then be asked to select which configuration, data and apps you want to backup.
|
||||
|
||||
|
||||
|
||||
#### From the command line
|
||||
|
||||
You can create a new backup archive with the command line. Here are a few simple example of commands and their corresponding behavior :
|
||||
|
||||
- Backing up everything (all system parts and apps) :
|
||||
```bash
|
||||
sudo mkdir /home/yunohost.backup/archives
|
||||
yunohost backup create
|
||||
```
|
||||
|
||||
Launch a backup via
|
||||
- Backing up only apps
|
||||
```bash
|
||||
sudo yunohost backup create
|
||||
yunohost backup create --apps
|
||||
```
|
||||
|
||||
|
||||
In this version you can backup with cli or with the web admin. The cli way allows you to do more things. The webadmin way is more accessible.
|
||||
|
||||
## Web admin
|
||||
Basically with the webadmin, you can:
|
||||
|
||||
- backup into `/home/yunohost.backup/archives/`
|
||||
- choose to backup one or more data among:
|
||||
- apps data
|
||||
- emails
|
||||
- home data
|
||||
- configuration
|
||||
- list backups
|
||||
- see what there is in a backup
|
||||
- restore selectively a backup
|
||||
|
||||
**Caution:** to do a backup, you need to have enough free disk spaces in the destination directory. For example, if you have 20GB in `/home/data` you need to have enough space to contain this 20GB compressed in a tar.gz. To do the tar.gz, yunohost backup uses shallow copies, to avoid to need more spaces to be able to create the tar.gz.
|
||||
|
||||
**Caution:** If you use selective restore, be sure to not create discordant operation. For example, if you restore an app using a domain that has been deleted from YunoHost, you need to read the domain or to restore all configuration files.
|
||||
|
||||
Here's a list of missing but planned features:
|
||||
|
||||
- backup in another memory device
|
||||
- download/upload backups
|
||||
- encrypt backups
|
||||
|
||||
Some features are almost ready in the webadmin, but the API is not for the moment.
|
||||
|
||||
## Command line
|
||||
### Backup
|
||||
You can make a full backup by running this command:
|
||||
- Backing up only two apps (wordpress and shaarli)
|
||||
```bash
|
||||
admin@yunohost:~# sudo yunohost backup create
|
||||
Exécution des scripts de sauvegarde...
|
||||
Attention : backup script '/etc/yunohost/apps/phpmyadmin/scripts/backup' not found
|
||||
Attention : App 'phpmyadmin' will not be saved
|
||||
Lancement du script de sauvegarde de l'application 'odoo'...
|
||||
Création de l'archive de sauvegarde...
|
||||
Succès ! Sauvegarde terminée
|
||||
archive:
|
||||
hooks:
|
||||
conf_ssh: /usr/share/yunohost/hooks/backup/08-conf_ssh
|
||||
conf_ynh_firewall: /usr/share/yunohost/hooks/backup/20-conf_ynh_firewall
|
||||
data_mail: /usr/share/yunohost/hooks/backup/23-data_mail
|
||||
conf_cron: /usr/share/yunohost/hooks/backup/32-conf_cron
|
||||
conf_ynh_certs: /usr/share/yunohost/hooks/backup/21-conf_ynh_certs
|
||||
conf_ynh_mysql: /usr/share/yunohost/hooks/backup/11-conf_ynh_mysql
|
||||
conf_xmpp: /usr/share/yunohost/hooks/backup/26-conf_xmpp
|
||||
data_home: /usr/share/yunohost/hooks/backup/17-data_home
|
||||
conf_nginx: /usr/share/yunohost/hooks/backup/29-conf_nginx
|
||||
conf_ssowat: /usr/share/yunohost/hooks/backup/14-conf_ssowat
|
||||
conf_ldap: /usr/share/yunohost/hooks/backup/05-conf_ldap
|
||||
created_at: 1448540733
|
||||
apps:
|
||||
odoo:
|
||||
version: -
|
||||
name: Odoo
|
||||
description: Odoo est une collection d'apps de gestion d'entreprise (ERP : CRM, Comptabilité, Point de Vente, RH, Achats, ...).
|
||||
description:
|
||||
name: 20151126-132533
|
||||
admin@yunohost:~# sudo ls /home/yunohost.backup/archives/
|
||||
20151126-132533.info.json 20151126-132533.tar.gz
|
||||
yunohost backup create --apps wordpress shaarli
|
||||
```
|
||||
By default, it backups in `/home/yunohost.backup/archives/`, but you can set your own directory with `-o` option. It could be an usb key or an other mounted filesystem.
|
||||
|
||||
If an app has no backup script it warns you.
|
||||
|
||||
As you can see in the answer, there is 2 hooks which backup data (data_home and data_mail). By default, the mysql data aren't saved, because the apps should save themselves their databases.
|
||||
|
||||
|
||||
**Note:** `yunohost backup` is not able currently to create diff backup. But you can use `-r` option to avoid compression and use an other backup tool to make diff backup.
|
||||
|
||||
### Restore
|
||||
To do a restore
|
||||
- Backing up only mails
|
||||
```bash
|
||||
admin@yunohost:~# sudo yunohost backup restore 20151126-132533
|
||||
yunohost backup create --system data_mail
|
||||
```
|
||||
You can choose to apply only some parts of the backup, by selecting which restore hooks and which apps to restore.
|
||||
|
||||
## Packaging information
|
||||
You can see an example to make backup and restore scripts here
|
||||
https://github.com/YunoHost/example_ynh/tree/testing
|
||||
and
|
||||
https://github.com/zamentur/strut_ynh/
|
||||
|
||||
There is some helpers to do shadow copy if you have big quantity of data to backup (owncloud, video apps, etc...).
|
||||
|
||||
**Note:** during a backup operation, the restore script associated is saved. So in a restore operation, yunohost use the saved restore script and not the most recent script.
|
||||
|
||||
If you want modify a general conf file, you should use hooks to trigger a modification of the conf file after each call of `yunohost regenconf`.
|
||||
You can also use the regeneration configuration system to do index your conf file, and allow your user to be warn if an upgrade of your app has change a config file.
|
||||
|
||||
## Annex
|
||||
- Backing up mails and wordpress
|
||||
```bash
|
||||
usage: yunohost backup create [-h] [-d DESCRIPTION] [-o OUTPUT_DIRECTORY]
|
||||
[-n NAME] [--ignore-hooks]
|
||||
[--hooks [HOOKS [HOOKS ...]]]
|
||||
[--apps [APPS [APPS ...]]] [-r] [--ignore-apps]
|
||||
|
||||
optional arguments:
|
||||
-h, --help show this help message and exit
|
||||
-d DESCRIPTION, --description DESCRIPTION
|
||||
Short description of the backup
|
||||
-o OUTPUT_DIRECTORY, --output-directory OUTPUT_DIRECTORY
|
||||
Output directory for the backup
|
||||
-n NAME, --name NAME Name of the backup archive
|
||||
--ignore-hooks Do not execute backup hooks
|
||||
--hooks [HOOKS [HOOKS ...]]
|
||||
List of backup hooks names to execute
|
||||
--apps [APPS [APPS ...]]
|
||||
List of application names to backup
|
||||
-r, --no-compress Do not create an archive file
|
||||
--ignore-apps Do not backup apps
|
||||
|
||||
usage: yunohost backup restore [-h] [--force] [--hooks [HOOKS [HOOKS ...]]]
|
||||
[--ignore-hooks] [--apps [APPS [APPS ...]]]
|
||||
[--ignore-apps]
|
||||
name
|
||||
|
||||
positional arguments:
|
||||
name Name of the local backup archive
|
||||
|
||||
optional arguments:
|
||||
-h, --help show this help message and exit
|
||||
--force Force restauration on an already installed system
|
||||
--hooks [HOOKS [HOOKS ...]]
|
||||
List of restauration hooks names to execute
|
||||
--ignore-hooks Do not restore hooks
|
||||
--apps [APPS [APPS ...]]
|
||||
List of application names to restore
|
||||
--ignore-apps Do not restore apps
|
||||
|
||||
|
||||
usage: yunohost backup [-h] {info,restore,create,list,delete} ...
|
||||
|
||||
optional arguments:
|
||||
-h, --help show this help message and exit
|
||||
|
||||
actions:
|
||||
{info,restore,create,list,delete}
|
||||
info Show info about a local backup archive
|
||||
restore Restore from a local backup archive
|
||||
create Create a backup local archive
|
||||
list List available local backup archives
|
||||
delete Delete a backup archive
|
||||
root@staging1:/home/admin# sudo yunohost backup list --help
|
||||
usage: yunohost backup list [-h] [-i] [-H]
|
||||
|
||||
optional arguments:
|
||||
-h, --help show this help message and exit
|
||||
-i, --with-info Show backup information for each archive
|
||||
-H, --human-readable Print sizes in human readable format
|
||||
yunohost backup create --system data_mail --apps wordpress
|
||||
```
|
||||
|
||||
For more informations and options about backup creation, consult `yunohost backup create --help`. You can also list system parts that can be backuped with `yunohost hook list backup`.
|
||||
|
||||
#### 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...
|
||||
|
||||
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.
|
||||
|
||||
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 :
|
||||
|
||||
```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
|
||||
|
||||
```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'.
|
||||
|
||||
|
||||
|
||||
#### From the command line
|
||||
|
||||
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
|
||||
|
||||
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 :
|
||||
|
||||
```bash
|
||||
yunohost backup restore <archivename>
|
||||
```
|
||||
|
||||
To go futher
|
||||
------------
|
||||
|
||||
#### Storing backups on a different drive
|
||||
|
||||
If you want, you can connect and mount an external drive to store backup archives on it (among other things). For this, we first move the existing archives then add a symbolic link.
|
||||
|
||||
```bash
|
||||
PATH_TO_DRIVE="/media/my_external_drive" # For instance, depends of where you mounted your drive
|
||||
mv /home/yunohost.backup/archives $PATH_TO_DRIVE/yunohost_backup_archives
|
||||
ln -s $PATH_TO_DRIVE/yunohost_backup_archives /home/yunohost.backup/archives
|
||||
```
|
||||
|
||||
#### Automatic backups
|
||||
|
||||
You can add a simple cron job to trigger automatic backups regularly. For instance, to backup your wordpress weekly, create a file `/etc/cron.weekly/backup-wordpress` with the following content :
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
yunohost backup create --apps wordpress
|
||||
```
|
||||
|
||||
then make it executable :
|
||||
|
||||
```bash
|
||||
chown +x /etc/cron.weekly/backup-wordpress
|
||||
```
|
||||
|
||||
Be careful what you backup exactly and when : you don't want to end up with your whole disk space saturated because you backuped 30 Go of data every day.
|
||||
|
||||
#### Backing your server on a remote server
|
||||
|
||||
You can follow this tutorial on the forum to setup Borg between two servers : https://forum.yunohost.org/t/how-to-backup-your-yunohost-server-on-another-server/3153
|
||||
|
||||
Alternatively, the app Archivist allows to setup a similar system : https://forum.yunohost.org/t/new-app-archivist/3747
|
||||
|
||||
#### Full backup with `dd`
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
(replace `/dev/mmcblk0` with the actual device of your sd card)
|
||||
|
|
|
|||
175
backup_fr.md
175
backup_fr.md
|
|
@ -1,48 +1,149 @@
|
|||
# Les sauvegardes
|
||||
Sauvegarder son serveur et ses apps
|
||||
===================================
|
||||
|
||||
**Prérequis :** vérifier que le dossier `archives` existe bien dans le dossier `/home/yunohost.backup/`
|
||||
sinon le créer via un
|
||||
Dans le contexte de l'auto-hébergement, les sauvegardes (backup) sont un éléments importants pour palier à des événements innatendus (incendis, corruption de base de données, perte d'accès au serveur, serveur compromis, ...). La politique de sauvegarder à mettre en place dépends de l'importance des services et des données que vous gérez. Par exemple, sauvegarder un serveur de test aura peu d'intérêt, tandis que vous voudrez être très prudent si vous gérez des données critiques pour une association ou une entreprise - et dans ce genre de cas vous souhaiterez stocker les sauvegardes *dans un endroit différent*.
|
||||
|
||||
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 sont pas disponible 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.
|
||||
|
||||
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).
|
||||
|
||||
|
||||
|
||||
#### Depuis la ligne de commande
|
||||
|
||||
Vous pouvez créer de nouvelles archives depuis la ligne de commande. Voici quelques exemples de commandes et leur comportement correspondant :
|
||||
|
||||
- Tout sauvegarder (système et application)
|
||||
```bash
|
||||
sudo mkdir /home/yunohost.backup/archives
|
||||
```
|
||||
Lancer la sauvegarde via
|
||||
```bash
|
||||
sudo yunohost backup create
|
||||
```
|
||||
Un fichier portant un numéro et une extension .tar.gz est créé
|
||||
(exemple 1452694078.tar.gz)
|
||||
|
||||
Cette archive contient une copie des dossiers suivants et fichiers de configurations dans les répertoires suivants
|
||||
- cron
|
||||
- home (car les données d’owncloud se trouvent dans `/home/yunohost.apps/owncloud` par exemple)
|
||||
- ldap
|
||||
- mail
|
||||
- mysql
|
||||
- nginx
|
||||
- ssh
|
||||
- ssowat
|
||||
- xmpp
|
||||
- yunohost
|
||||
|
||||
Cette sauvegarde sous forme d’archive est à copier sur un autre support (support mémoire, répertoire réseau…)
|
||||
|
||||
Pour récupérer une sauvegarde depuis son serveur vers le /home de son ordinateur (avec 1234 comme port SSH ; avec IP_ou_NDD comme adresse IP [locale ou pas] ou NDD son Nom De Domaine ; avec $USER son nom d'utilisateur ; avec aaaammjj-hhmmss comme par exemple 20161002-084907 [nom de la sauvegarde YunoHost]) :
|
||||
```bash
|
||||
scp -P 1234 root@IP_ou_NDD:/home/yunohost.backup/archives/aaaammjj-hhmmss.tar.gz /home/$USER
|
||||
scp -P 1234 root@IP_ou_NDD:/home/yunohost.backup/archives/aaaammjj-hhmmss.info.json /home/$USER
|
||||
yunohost backup create
|
||||
```
|
||||
|
||||
Sur le même principe que précédemment, envoyer une sauvegarde depuis le /home de son ordinateur vers son serveur (s'assurer que le dossier archive existe bien sinon lancer une première sauvegarde ou bien en dernier recours créer le dossier en root : mkdir /home/yunohost.backup/archives) :
|
||||
- Sauvegarder seulement les apps
|
||||
```bash
|
||||
scp -P 1234 /home/$USER/aaaammjj-hhmmss.info.json root@IP_ou_NDD:/home/yunohost.backup/archives
|
||||
scp -P 1234 /home/$USER/aaaammjj-hhmmss.tar.gz root@IP_ou_NDD:/home/yunohost.backup/archives
|
||||
yunohost backup create --apps
|
||||
```
|
||||
|
||||
# Pour restaurer une sauvegarde :
|
||||
- Sauvegarder seulement deux apps (wordpress et shaarli)
|
||||
```bash
|
||||
yunohost backup restore nom_de_la_sauvegarde
|
||||
yunohost backup create --apps wordpress shaarli
|
||||
```
|
||||
|
||||
# Pour déplacer ses sauvegardes sur un autre disque dur
|
||||
- Sauvegarder seulement les mails
|
||||
```bash
|
||||
yunohost backup create --system data_mail
|
||||
```
|
||||
|
||||
Il suffit de monter son disque dur dans le dossier /home/yunohost.backup/archives
|
||||
- Sauvegarder les mails et wordpress
|
||||
```bash
|
||||
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`.
|
||||
|
||||
#### Configuration spécifiques à certaines apps
|
||||
|
||||
Certaines apps comme Nextcloud sont potentiellement rataché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...
|
||||
|
||||
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.
|
||||
|
||||
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 :
|
||||
|
||||
```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 :
|
||||
|
||||
```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
|
||||
-------------------------
|
||||
|
||||
#### Depuis la webadmin
|
||||
|
||||
Allez dans Sauvegardes > Sauvegardes locales et sélectionnez l'archive. Vous pouvez ensuite choisir les différents éléments que vous voulez restaurer puis cliquer sur "Restaurer".
|
||||
|
||||
|
||||
|
||||
#### Depuis la ligne de commande
|
||||
|
||||
Depuis la ligne de commande, vous pouvez utiliser `yunohost backup restore <nom_d'archive>` (sans le `.tar.gz`) pour restaurer une archive. Tout comme `yunohost backup create`, cela restaure tout le contenu par défaut. Si vous souhaitez restaurer seulement certaines parties, vous pouvez utiliser par exemple `yunohost backup restore --apps wordpress` qui restaurera seulement l'app wordpress.
|
||||
|
||||
#### Contraintes
|
||||
|
||||
Pour restaurer une application, le domaine sur laquelle elle est installée doit déjà être configuré (ou il vous faut restaurer en même temps la configuration correspondante). Aussi, il n'est pas possible de restaurer une application déjà installée ... ce qui veut dire que pour restaurer une sauvegarde d'une app, il vous faut déjà la désinstaller.
|
||||
|
||||
#### 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'archie sur le server et la placer dans `/home/yunohost.backup/archives`. Ensuite, à la place de `yunohost tools poinstall` vous pouvez faire :
|
||||
|
||||
```bash
|
||||
yunohost backup restore <nom_d'archive>
|
||||
```
|
||||
|
||||
Pour aller plus loin
|
||||
--------------------
|
||||
|
||||
#### Stocker les archives sur un autre disque
|
||||
|
||||
Si vous le souhaitez, vous pouvez connecter un disque externe à votre serveur pour (parmis d'autres choses) stocker les archives de backup dessus. Pour cela, il faut d'abord déplacer les archives existantes vers le disque, puis créer un lien symbolique :
|
||||
|
||||
```bash
|
||||
PATH_TO_DRIVE="/media/mon_disque_externe" # Par exemple - Tout dépends de où le disque est monté
|
||||
mv /home/yunohost.backup/archives $PATH_TO_DRIVE/yunohost_backup_archives
|
||||
ln -s $PATH_TO_DRIVE/yunohost_backup_archives /home/yunohost.backup/archives
|
||||
```
|
||||
|
||||
#### Sauvegardes automatiques
|
||||
|
||||
Vous pouvez ajouter une tâche cron pour déclencer 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 executable :
|
||||
|
||||
```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 ...
|
||||
|
||||
#### Sauvegarder sur un serveur distant
|
||||
|
||||
Vous pouvez suivre ce tutorial 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
|
||||
|
||||
#### 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 :
|
||||
|
||||
```bash
|
||||
dd if=/dev/mmcblk0 of=./backup.img
|
||||
```
|
||||
|
||||
(remplacez `/dev/mmcblk0` par le vrai nom de votre carte SD)
|
||||
|
|
|
|||
|
|
@ -88,22 +88,6 @@ A <a href="http://list.yunohost.org/cgi-bin/mailman/listinfo/apps">mailing-list<
|
|||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
|
||||
<div class="row">
|
||||
<div class="col col-md-3 lead">
|
||||
<span class="glyphicon glyphicon glyphicon-upload"></span> Seed
|
||||
</div>
|
||||
<div class="col col-md-8" markdown="1">
|
||||
Seed (share) YunoHost images with Torrent system: [live](http://build.yunohost.org/yunohost-live.iso.torrent), [32 bits](http://build.yunohost.org/yunohostv2-latest-i386.iso.torrent) and [64 bits](http://build.yunohost.org/yunohostv2-latest-amd64.iso.torrent).
|
||||
</div>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
-->
|
||||
|
||||
---
|
||||
|
||||
<br>
|
||||
|
|
|
|||
|
|
@ -86,21 +86,6 @@ Un [salon de développement](xmpp:dev@conference.yunohost.org?join) et une <a hr
|
|||
|
||||
---
|
||||
|
||||
<!--
|
||||
|
||||
<div class="row">
|
||||
<div class="col col-md-3 lead">
|
||||
<span class="glyphicon glyphicon glyphicon-upload"></span> إزرعوا
|
||||
</div>
|
||||
<div class="col col-md-8" markdown="1">
|
||||
Seedez (partagez) avec le système de Torrent les images de YunoHost : [live](http://build.yunohost.org/yunohost-live.iso.torrent), [32 bits](http://build.yunohost.org/yunohostv2-latest-i386.iso.torrent) et [64 bits](http://build.yunohost.org/yunohostv2-latest-amd64.iso.torrent).
|
||||
</div>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
-->
|
||||
|
||||
<br>
|
||||
<br>
|
||||
<p dir="rtl" class="lead" markdown="1">على أي حال تعالوا و انضموا إلى [غرفة المحادثة الخاصة بالمطوّرين](xmpp:dev@conference.yunohost.org?join) إن كنتم ترغبون في المساهمة :-)</p>
|
||||
|
|
|
|||
|
|
@ -86,21 +86,6 @@ Un [salon de développement](xmpp:dev@conference.yunohost.org?join) et une <a hr
|
|||
|
||||
---
|
||||
|
||||
<!--
|
||||
|
||||
<div class="row">
|
||||
<div class="col col-md-3 lead">
|
||||
<span class="glyphicon glyphicon glyphicon-upload"></span> Seedez
|
||||
</div>
|
||||
<div class="col col-md-8" markdown="1">
|
||||
Seedez (partagez) avec le système de Torrent les images de YunoHost : [live](http://build.yunohost.org/yunohost-live.iso.torrent), [32 bits](http://build.yunohost.org/yunohostv2-latest-i386.iso.torrent) et [64 bits](http://build.yunohost.org/yunohostv2-latest-amd64.iso.torrent).
|
||||
</div>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
-->
|
||||
|
||||
<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>
|
||||
|
|
|
|||
|
|
@ -1,5 +1,8 @@
|
|||
# Create a YunoHost Live ISO
|
||||
|
||||
<div class="alert alert-danger">This page is deprecated / obsolete / outdated. Information
|
||||
it contains should be updated (or should be removed).</div>
|
||||
|
||||
Tested on Debian Wheezy (should work on Ubuntu as well).
|
||||
Original tutorial here: http://willhaley.com/blog/create-a-custom-debian-live-environment/
|
||||
|
||||
|
|
|
|||
|
|
@ -1,5 +1,8 @@
|
|||
# Créer une Live ISO de YunoHost
|
||||
|
||||
<div class="alert alert-danger">This page is deprecated / obsolete / outdated. Information
|
||||
it contains should be updated (or should be removed).</div>
|
||||
|
||||
Testé sur Debian Wheezy (devrait marcher sur Ubuntu également).
|
||||
Tutoriel original : http://willhaley.com/blog/create-a-custom-debian-live-environment/
|
||||
|
||||
|
|
|
|||
|
|
@ -1,40 +1,28 @@
|
|||
## Configuration desktop email client
|
||||
## Configuring email client
|
||||
|
||||
*[Documentation linked to YunoHost email](/email_fr)*.
|
||||
You can fetch and send emails using your YunoHost instance from desktop email clients such as Mozilla Thunderbird or on your smartphone with applications like K-9 Mail.
|
||||
|
||||
You can access your emails via desktop email clients such as Mozilla Thunderbird.
|
||||
##### Generic settings
|
||||
|
||||
#### Requirements
|
||||
* Email address
|
||||
* Password of the user account
|
||||
| Protocol | Port | Encryption | Authentication | Username |
|
||||
| :--: | :-: | :--: | :--: | :--: |
|
||||
| IMAP | 993 | SSL/TLS | Normal password | `username` (without the `@domain.tld`) |
|
||||
| SMTP | 587 | STARTTLS | Normal password | `username` (without the `@domain.tld`) |
|
||||
|
||||
##### Settings
|
||||
| Protocol | Port | Encryption |
|
||||
| :--: | :-: | :--: |
|
||||
| IMAP | 993 | SSL/TLS |
|
||||
| SMTP | 465 | SSL/TLS |
|
||||
### <img src="images/thunderbird.png" width=50> Configure Mozilla Thunderbird (on a desktop computer)
|
||||
|
||||
#### Mozilla Thunderbird
|
||||
The automatic detection tool of Thunderbird does not work yet with YunoHost. You will need to set it up manually. To do so, add the account information, then select port 993 with SSL/TLS for IMAP, and port 587 with STARTTLS for SMTP. Afterwards select 'Normal Password' for Authentication and click on 'Advanced Config'. You will need to accept the certificate exceptions for fetching mails and after you send your first mail. Don't forget to remove the dot before the domain name.
|
||||
|
||||
The automatic detection tool of Thunderbird does not work with YunoHost. You will need to set it up manually. To do so, add the account information, then select SSL/TLS for IMAP and SMTP. Afterwards select 'Normal Password' for Authentication and click on 'Advanced Config'. You will need to accept the certificate exceptions for fetching mails and after you send your first mail. Remove dot before domain name.
|
||||
|
||||
<img src="/images/thunderbird-config.png" width=900>
|
||||
<img src="/images/thunderbird_config_1.png" width=900>
|
||||
<img src="/images/thunderbird_config_2.png" width=900>
|
||||
|
||||
* [Manage alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
|
||||
|
||||
#### For Android
|
||||
[K-9 Mail](https://en.wikipedia.org/wiki/K-9_Mail) application works.
|
||||
### <img src="images/k9mail.png" width=50> Configure K-9 Mail (on Android)
|
||||
|
||||
#### For Firefox OS
|
||||
Follow the following steps. (As for thunderbird, you might need to accept certificates at some points)
|
||||
|
||||
Tested with Firefox OS 2.6.
|
||||
On the home screen, enter the user name and the email address. Then use manual configuration:
|
||||
|
||||
<a href="/images/ffos_email_config_home_screen_empty.png"><img src="/images/ffos_email_config_home_screen_empty.png" width=200/></a> <a href="/images/ffos_email_config_home_screen_fill.png"><img src="/images/ffos_email_config_home_screen_fill.png" width=200/></a>
|
||||
|
||||
Configure manually the form as shown on following screenshots:
|
||||
|
||||
<a href="/images/ffos_email_config_manual_conf_empty.png"><img src="/images/ffos_email_config_manual_conf_empty.png" width=200/></a> <a href="/images/ffos_email_config_manual_conf_fill.png"><img src="/images/ffos_email_config_manual_conf_fill.png" width=200/></a>
|
||||
|
||||
|
||||
<a href="/images/ffos_email_config_manual_conf_2_empty.png"><img src="/images/ffos_email_config_manual_conf_2_empty.png" width=200/></a> <a href="/images/ffos_email_config_manual_conf_2_fill.png"><img src="/images/ffos_email_config_manual_conf_2_fill.png" width=200/></a>
|
||||
<a href="/images/k9mail_config_1.png"><img src="/images/k9mail_config_1.png" width=200/></a>
|
||||
<a href="/images/k9mail_config_2.png"><img src="/images/k9mail_config_2.png" width=200/></a>
|
||||
<a href="/images/k9mail_config_3.png"><img src="/images/k9mail_config_3.png" width=200/></a>
|
||||
<a href="/images/k9mail_config_4.png"><img src="/images/k9mail_config_4.png" width=200/></a>
|
||||
|
|
|
|||
|
|
@ -1,46 +1,28 @@
|
|||
## Configuration client email de bureau
|
||||
## Configuration desktop email client
|
||||
|
||||
*[Documentation en rapport avec l’email de YunoHost](/email_fr)*.
|
||||
Vous pouvez récupérer et envoyer des emails avec votre instance YunoHost grâce à des logiciels comme Mozilla Thunderbird, ou sur votre smartphone grâce à des applications comme K-9 Mail.
|
||||
|
||||
Il est possible d’accéder à ses emails grâce à un client lourd de messagerie électronique tel que Mozilla Thunderbird.
|
||||
##### Réglages génériques
|
||||
|
||||
#### Prérequis
|
||||
* Adresse email principale
|
||||
* Mot de passe du compte utilisateur
|
||||
| Protocole | Port | Chiffrement | Authentification | Login |
|
||||
| :--: | :-: | :--: | :--: | :--: |
|
||||
| IMAP | 993 | SSL/TLS | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
|
||||
| SMTP | 587 | STARTTLS | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
|
||||
|
||||
#### Réglages génériques
|
||||
| Protocole | Port | Chiffrement |
|
||||
| :--: | :-: | :--: |
|
||||
| IMAP | 993 | SSL/TLS |
|
||||
| SMTP | 465 | SSL/TLS |
|
||||
### <img src="images/thunderbird.png" width=50> Configurer Mozilla Thunderbird
|
||||
|
||||
#### Mozilla Thunderbird
|
||||
L’utilitaire de détection automatique de Thunderbird ne fonctionne pas avec le serveur email de YunoHost. Il faut donc passer en configuration manuelle. N’oubliez pas d’enlever le point devant le nom de domaine.
|
||||
L'outil de détection automatique de Thunderbird ne fonctionne actuellement pas avec YunoHost. Il vous faudra remplir les champs manuellement. Commencez par remplir les informations de base (Nom, adresse et mot de passe), cliquez sur Continuer puis Configuration Manuelle. Enlevez le `.` avant le nom de domaine. Sélectionnez le port 993 avec SSL/TLS pour IMAP, et le port 586 avec STARTTLS pour SMTP. Sélectionnez 'Mot de passe normal' pour l'authentification. Testez la configuration puis validez. (Il vous faudra ensuite possiblement accepter des certificats pour que tout fonctionne correctement.)
|
||||
|
||||
<img src="/images/thunderbird-config.png" width=900>
|
||||
<img src="/images/thunderbird_config_1.png" width=900>
|
||||
<img src="/images/thunderbird_config_2.png" width=900>
|
||||
|
||||
Pour le mot de passe: il faut saisir le mot de passe de l'utilisateur yunohost.
|
||||
Pour l'identifiant: il faut saisir le nom de l'utilisateur yunohost.
|
||||
* [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
|
||||
|
||||
Note : si votre instance Yunohost gère plusieurs noms de domaine, il faut utiliser celui définit comme "nom de domaine par défaut" dans l'interface de gestion des noms de domaines. Et ce, même si le domaine de votre adresse mail en est un autre.
|
||||
### <img src="images/k9mail.png" width=50> Configurer K-9 Mail (sur Android)
|
||||
|
||||
Suivez les instructions suivantes. (Comme pour Thunderbird, il vous faudra peut-être accepter des certificats à un moment)
|
||||
|
||||
* [Gestion des alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
|
||||
|
||||
#### Pour Android
|
||||
L’application [K-9 Mail](https://github.com/k9mail) fonctionne.
|
||||
|
||||
|
||||
#### Pour Firefox OS
|
||||
|
||||
Testé avec Firefox OS 2.6.
|
||||
Sur la page d’accueil, entrez votre nom d’utilisateur et l’adresse email, puis allez dans la configuration manuelle :
|
||||
|
||||
<a href="/images/ffos_email_config_home_screen_empty.png"><img src="/images/ffos_email_config_home_screen_empty.png" width=200/></a> <a href="/images/ffos_email_config_home_screen_fill.png"><img src="/images/ffos_email_config_home_screen_fill.png" width=200/></a>
|
||||
|
||||
Configurer manuellement le formulaire comme indiqué sur les captures d’écran suivantes :
|
||||
|
||||
<a href="/images/ffos_email_config_manual_conf_empty.png"><img src="/images/ffos_email_config_manual_conf_empty.png" width=200/></a> <a href="/images/ffos_email_config_manual_conf_fill.png"><img src="/images/ffos_email_config_manual_conf_fill.png" width=200/></a>
|
||||
|
||||
|
||||
<a href="/images/ffos_email_config_manual_conf_2_empty.png"><img src="/images/ffos_email_config_manual_conf_2_empty.png" width=200/></a> <a href="/images/ffos_email_config_manual_conf_2_fill.png"><img src="/images/ffos_email_config_manual_conf_2_fill.png" width=200/></a>
|
||||
<a href="/images/k9mail_config_1.png"><img src="/images/k9mail_config_1.png" width=200/></a>
|
||||
<a href="/images/k9mail_config_2.png"><img src="/images/k9mail_config_2.png" width=200/></a>
|
||||
<a href="/images/k9mail_config_3.png"><img src="/images/k9mail_config_3.png" width=200/></a>
|
||||
<a href="/images/k9mail_config_4.png"><img src="/images/k9mail_config_4.png" width=200/></a>
|
||||
|
|
|
|||
Binary file not shown.
|
Before Width: | Height: | Size: 54 KiB |
BIN
images/backup.png
Normal file
BIN
images/backup.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 36 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 44 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 48 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 34 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 32 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 41 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 36 KiB |
BIN
images/k9mail.png
Normal file
BIN
images/k9mail.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 15 KiB |
BIN
images/k9mail_config_1.png
Normal file
BIN
images/k9mail_config_1.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 24 KiB |
BIN
images/k9mail_config_2.png
Normal file
BIN
images/k9mail_config_2.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
BIN
images/k9mail_config_3.png
Normal file
BIN
images/k9mail_config_3.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 43 KiB |
BIN
images/k9mail_config_4.png
Normal file
BIN
images/k9mail_config_4.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 33 KiB |
BIN
images/restore.png
Normal file
BIN
images/restore.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 28 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 57 KiB |
BIN
images/thunderbird.png
Normal file
BIN
images/thunderbird.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
BIN
images/thunderbird_config_1.png
Normal file
BIN
images/thunderbird_config_1.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 28 KiB |
BIN
images/thunderbird_config_2.png
Normal file
BIN
images/thunderbird_config_2.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 46 KiB |
|
|
@ -84,7 +84,7 @@ This page lists a few installation guides.
|
|||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_debian"><img height=150 src="/images/debian-logo.png" style="vertical-align:bottom">
|
||||
<b><p>On Debian 8/Jessie</p></b></a>
|
||||
<b><p>On Debian 9/Stretch</p></b></a>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -78,7 +78,7 @@ Cette page liste plusieurs types d’installations, classés par catégories.
|
|||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_debian_fr"><img height=150 src="/images/debian-logo.png" style="vertical-align:bottom">
|
||||
<b><p>Sur Debian 8/Jessie</p></b></a>
|
||||
<b><p>Sur Debian 9/Stretch</p></b></a>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -13,8 +13,6 @@ You can use any computer with **256MB RAM or more**.
|
|||
* Another computer to read this guide and access to your server.
|
||||
* A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth
|
||||
* A **USB stick** of at least 1GB capacity **OR** a standard **blank CD**
|
||||
* One of the latest **YunoHost ISO images**, available here (take the 32 Bits one if you don't know which one to choose):
|
||||
- https://build.yunohost.org
|
||||
* ***Particular case*** : If your server has no graphic card, [prepare iso for booting with serial port](https://github.com/luffah/debian-mkserialiso).
|
||||
|
||||
---
|
||||
|
|
@ -22,7 +20,7 @@ You can use any computer with **256MB RAM or more**.
|
|||
## Installation steps
|
||||
|
||||
|
||||
<a class="btn btn-lg btn-default" href="https://build.yunohost.org">0. Download your ISO image</a>
|
||||
<a class="btn btn-lg btn-default" href="/images">0. Download your ISO image</a>
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Burn or copy ISO image</a>
|
||||
|
||||
|
|
|
|||
|
|
@ -12,15 +12,13 @@
|
|||
* Un autre ordinateur pour parcourir ce guide et accéder à votre serveur
|
||||
* Un [fournisseur d’accès correct](/isp_fr), de préférence avec une bonne vitesse d’upload
|
||||
* Une **clé USB** d’une capacité minimum d’1Go **OU** un **CD vierge** standard
|
||||
* Une des dernières **images ISO YunoHost** (dans le doute prenez la version 32 bits) :
|
||||
- https://build.yunohost.org
|
||||
* ***Cas particulier*** : Si votre serveur n'a pas de carte graphique, il faut [préparer un iso qui démarre sur le port série](https://github.com/luffah/debian-mkserialiso).
|
||||
|
||||
---
|
||||
|
||||
## Étapes d’installation
|
||||
|
||||
<a class="btn btn-lg btn-default" href="https://build.yunohost.org">0. Télécharger l'image ISO</a>
|
||||
<a class="btn btn-lg btn-default" href="/images">0. Télécharger l'image ISO</a>
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/burn_or_copy_iso_fr">1. Copier l’image ISO</a>
|
||||
|
||||
|
|
|
|||
|
|
@ -1,44 +1,18 @@
|
|||
# Install YunoHost manually
|
||||
# Installing YunoHost manually
|
||||
|
||||
Once you have access to your server, either directly or by SSH, you can install YunoHost using the install script.
|
||||
Once you have access to a command line on your server (either directly or through SSH), you can install yunohost by running command as root :
|
||||
|
||||
<div class="alert alert-info">
|
||||
<b>Note:</b> The configuration of your services will be overridden, it is thus recommended to install YunoHost on a newly installed Debian system.
|
||||
</div>
|
||||
|
||||
1. Install git
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install ca-certificates dialog git
|
||||
bash <(wget -q -O- https://install.yunohost.org/)
|
||||
```
|
||||
|
||||
2. Clone the Yunohost install script repository
|
||||
```bash
|
||||
git clone https://github.com/YunoHost/install_script /tmp/install_script
|
||||
```
|
||||
<small>*(If `wget` is not installed on your system, you might need to install it with `apt install wget`)*</small>
|
||||
|
||||
3. The root user must have a password set, if it isn't the case, set it (otherwise, the install script fails):
|
||||
```bash
|
||||
sudo passwd root
|
||||
```
|
||||
|
||||
4. Execute the installation script
|
||||
```bash
|
||||
cd /tmp/install_script && sudo ./install_yunohost
|
||||
```
|
||||
|
||||
<br>
|
||||
|
||||
<p class="text-center">
|
||||
<img src="/images/install_script.png">
|
||||
</p>
|
||||
|
||||
<br>
|
||||
|
||||
<div class="alert alert-warning">
|
||||
<b>Warning:</b> Apache could already be installed by default on your dedicated server. If it's the case the installation script will fail since YunoHost is using Nginx. You will have to remove *apache2.2* package with the command: ``sudo apt-get autoremove apache2.2`` and execute the script again.
|
||||
</div>
|
||||
Once the installation is finished, you may want to [**proceed to post-installation**](/postinstall)
|
||||
|
||||
---
|
||||
|
||||
*Once the installation is finished, you may want to proceed to post-installation: **[yunohost.org/postinstall](/postinstall)** *
|
||||
**Note for advanced users concerned with the `curl|bash` approach**
|
||||
|
||||
If you strongly object to the `curl|bash` way (and similar commands) of installing software, consider reading ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) on Sandstom's blog, and possibly [this discussion on Hacker News](https://news.ycombinator.com/item?id=12766350).
|
||||
|
||||
|
|
|
|||
|
|
@ -1,43 +1,18 @@
|
|||
# Installer YunoHost manuellement
|
||||
|
||||
Une fois que vous avez accès à votre serveur, directement ou par SSH, vous pouvez installer YunoHost avec le script d’installation.
|
||||
Une fois que vous avez accès à votre serveur (directement ou par SSH), vous pouvez installer YunoHost en executant cette commande en tant que root :
|
||||
|
||||
<div class="alert alert-info">
|
||||
<b>Note :</b> La configuration des services sera écrasée, il est donc recommandé d’installer YunoHost sur un système Debian nouvellement installé.
|
||||
</div>
|
||||
|
||||
1. Installez git
|
||||
```bash
|
||||
sudo apt-get install git dialog
|
||||
bash <(wget -q -O- https://install.yunohost.org/)
|
||||
```
|
||||
|
||||
2. Clonez le dépôt du script d’installation de YunoHost
|
||||
```bash
|
||||
git clone https://github.com/YunoHost/install_script /tmp/install_script
|
||||
```
|
||||
<small>*(Si `wget` n'est pas installé sur votre système, il vous faudra peut-être l'installer avec `apt install wget`)*</small>
|
||||
|
||||
3. L’utilisateur root doit avoir un mot de passe, si ce n’est pas le cas, créez-en un (sinon le script d’installation échoue) :
|
||||
```bash
|
||||
sudo passwd root
|
||||
```
|
||||
|
||||
4. Lancez le script d’installation
|
||||
```bash
|
||||
cd /tmp/install_script && sudo ./install_yunohost
|
||||
```
|
||||
|
||||
<br>
|
||||
|
||||
<p class="text-center">
|
||||
<img src="/images/install_script.png">
|
||||
</p>
|
||||
|
||||
<br>
|
||||
|
||||
<div class="alert alert-warning">
|
||||
<b>Attention :</b> il se peut qu’Apache soit déjà installé par défaut sur votre serveur dédié. Si c’est le cas, le script d’installation échouera vu que YunoHost utilise Nginx. Vous aurez à désinstaller le paquet *apache2.2* avec la commande : ``sudo apt-get autoremove apache2.2`` et relancer le script.
|
||||
</div>
|
||||
Une fois l'installation terminée, il vous faudra [**procéder à la post-installation**](/postinstall)
|
||||
|
||||
---
|
||||
|
||||
*Une fois l’installation terminée, vous pouvez procéder à la post-installation : **[yunohost.org/postinstall](/postinstall_fr)** *
|
||||
**Note pour les utilisateurs avancés inquiets à propos de l'approche `curl|bash`**
|
||||
|
||||
Si vous êtes suspicieux de la tendance à utiliser `curl|bash` (ou commandes similaires) pour déployer des logiciels, prenez le temps de lire ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) sur le blog de Sandstom, et possiblement [cette discussion sur Hacker News](https://news.ycombinator.com/item?id=12766350).
|
||||
|
||||
|
|
|
|||
|
|
@ -14,7 +14,7 @@
|
|||
---
|
||||
|
||||
## Installation
|
||||
* Download the latest **[image of ARMbian Jessie for the ARM board](http://www.armbian.com/download)**
|
||||
* Download the latest **[image of ARMbian Stretch for the ARM board](http://www.armbian.com/download)**
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/copy_image">Copy image to the SD card</a>
|
||||
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@
|
|||
|
||||
## Installation
|
||||
|
||||
* Télécharger la dernière **[image d’ARMbian Jessie pour la carte ARM](http://www.armbian.com/download)**.
|
||||
* Télécharger la dernière **[image d’ARMbian Stretch pour la carte ARM](http://www.armbian.com/download)**.
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/copy_image_fr">Copier l’image sur une carte SD</a>
|
||||
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@
|
|||
|
||||
An ARM box, a VPS, a dedicated server, a standard x86 computer, an old Macintosh, ...
|
||||
|
||||
* with **Debian 8** (Jessie) installed
|
||||
* with **Debian 9** (Stretch) installed
|
||||
* connected to the Internet
|
||||
* with a direct **root access** or via SSH
|
||||
|
||||
|
|
|
|||
|
|
@ -8,8 +8,8 @@
|
|||
|
||||
Sur une plateforme ARM, un VPS, un serveur dédié, un ordinateur x86 standard, un vieux Macintosh,...
|
||||
|
||||
* avec **Debian 8** (Jessie) d’installé
|
||||
* connecté à Internet avec un câble RJ-45
|
||||
* avec **Debian 9** (Stretch) installé
|
||||
* connecté à Internet
|
||||
* avec un **accès root** directement ou par SSH
|
||||
|
||||
<img width=650 src="/images/debian_install.png">
|
||||
|
|
|
|||
|
|
@ -88,7 +88,7 @@ After connecting, you will be asked to changed the root password. First, enter *
|
|||
|
||||
Update your server with the following commands. It can take around 15 minutes.
|
||||
```bash
|
||||
apt-get update && apt-get dist-upgrade
|
||||
apt update && apt dist-upgrade
|
||||
```
|
||||
|
||||
## Proceed to post-installation
|
||||
|
|
|
|||
|
|
@ -86,7 +86,7 @@ ssh root@192.168.x.y
|
|||
|
||||
Mettre à jour le système (environ 15 minutes) :
|
||||
```bash
|
||||
apt-get update && apt-get dist-upgrade
|
||||
apt update && apt dist-upgrade
|
||||
```
|
||||
|
||||
## Procéder à la postinstallation
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ Before setting up a server at home, it is recommended that you know the [possibl
|
|||
|
||||
## Installation using the image (recommended)
|
||||
|
||||
<a class="btn btn-lg btn-default" href="https://build.yunohost.org/">0. Download the pre-installed image for Raspberry Pi</a>
|
||||
<a class="btn btn-lg btn-default" href="/images">0. Download the pre-installed image for Raspberry Pi</a>
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/copy_image">1. Copy image to the SD card</a>
|
||||
|
||||
|
|
@ -40,10 +40,10 @@ We do not recommend the manual installation because it is more technical and lon
|
|||
</div>
|
||||
|
||||
<div class="alert alert-warning" markdown="1">
|
||||
The latest Rasbpian Jessie image requires a screen and a keyboard, as it is no longer possible to connect directly to the Raspberry through SSH. Nevertheless it is possible to re-enable SSH at boot : before starting your Raspberry, put in the boot partition of the SD card an empty file named `ssh` (without extension).
|
||||
The latest Rasbpian images requires a screen and a keyboard, as it is no longer possible to connect directly to the Raspberry through SSH. Nevertheless it is possible to re-enable SSH at boot : before starting your Raspberry, put in the boot partition of the SD card an empty file named `ssh` (without extension).
|
||||
</div>
|
||||
|
||||
0. Install Raspbian Jessie Lite on the SD card ([instructions](https://www.raspberrypi.org/downloads/raspbian/)).
|
||||
0. Install Raspbian Stretch Lite on the SD card ([instructions](https://www.raspberrypi.org/downloads/raspbian/)).
|
||||
|
||||
1. Connect to your Raspberry Pi with the user `pi`. Set the root password with
|
||||
```bash
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ Avant d'héberger un serveur chez vous, il est recommandé de prendre connaissan
|
|||
|
||||
## Installation avec l'image (recommandée)
|
||||
|
||||
<a class="btn btn-lg btn-default" href="http://build.yunohost.org/">1. Télécharger l'image pour Raspberry Pi</a>
|
||||
<a class="btn btn-lg btn-default" href="/images">1. Télécharger l'image pour Raspberry Pi</a>
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/copy_image_fr">2. Copier l’image sur une carte SD</a>
|
||||
|
||||
|
|
@ -43,7 +43,7 @@ Nous déconseillons l'installation manuelle car elle est plus technique et plus
|
|||
Les dernières versions de Raspbian nécessitent un écran et un clavier, car il n'est plus possible de se connecter directement en SSH au Raspberry par défaut. Néanmoins, il est possible de réactiver le lancement de SSH au boot : il suffit de placer dans la partition boot de la carte SD un fichier nommé `ssh`, vide et sans extension.
|
||||
</div>
|
||||
|
||||
0. Installez Raspbian Jessie Lite ([instructions](https://www.raspberrypi.org/downloads/raspbian/)) sur la carte SD.
|
||||
0. Installez Raspbian Stretch Lite ([instructions](https://www.raspberrypi.org/downloads/raspbian/)) sur la carte SD.
|
||||
|
||||
1. Connectez-vous en ssh au Raspberry Pi avec l'utilisateur pi. Définissez un mot de passe root avec
|
||||
```bash
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<img src="/images/virtualbox.png" width=200>
|
||||
|
||||
* A x86 computer with VirtualBox installed and enough RAM capacity to be able to run a small virtual machine.
|
||||
* The latest stable **YunoHost ISO image**, available [here](https://build.yunohost.org).
|
||||
* The latest stable **YunoHost ISO image**, available [here](/images).
|
||||
|
||||
|
||||
---
|
||||
|
|
@ -48,7 +48,7 @@ Start the virtual machine
|
|||
|
||||
<br>
|
||||
|
||||
You will have to select your ISO image `yunohostv2-latest-amd64.iso` here, then you should see the YunoHost's boot screen.
|
||||
You will have to select your ISO image here, then you should see the YunoHost's boot screen.
|
||||
|
||||
<br>
|
||||
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<img src="/images/virtualbox.png" width=200>
|
||||
|
||||
* Un ordinateur x86 avec VirtualBox installé et assez de RAM disponible pour lancer une petite machine virtuelle.
|
||||
* La dernière **image ISO YunoHost** stable, disponible [ici](https://build.yunohost.org).
|
||||
* La dernière **image ISO YunoHost** stable, disponible [ici](/images).
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -47,7 +47,7 @@ Démarrez votre machine virtuelle
|
|||
|
||||
<br>
|
||||
|
||||
Vous devez sélectionner ici l’image ISO `yunohostv2-latest-amd64.iso`, puis vous devriez voir cet écran d’accueil YunoHost.
|
||||
Vous devez sélectionner ici l’image ISO, puis vous devriez voir cet écran d’accueil YunoHost.
|
||||
|
||||
<br>
|
||||
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@
|
|||
|
||||
* A dedicated or virtual private server
|
||||
* with at least **512MB** RAM
|
||||
* and **Debian 8.x (Jessie) 64bits** as operating system
|
||||
* and **Debian 9.x (Stretch) 64bits** as operating system
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@
|
|||
|
||||
* Un serveur dédié ou virtuel
|
||||
* avec au moins **512MB** RAM
|
||||
* et **Debian 8.x (Jessie) 64bits** comme système d'exploitation
|
||||
* et **Debian 9.x (Stretch) 64bits** comme système d'exploitation
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -41,7 +41,7 @@ Pour pouvoir envoyer des mails, passer le blocage en « inactif ».
|
|||
|
||||
Il faut installer le paquet `cifs-utils`
|
||||
```bash
|
||||
$ sudo apt-get install cifs-utils
|
||||
$ sudo apt install cifs-utils
|
||||
```
|
||||
|
||||
Il faut créer un point de montage (ici `/home/monlogin/freebox`)
|
||||
|
|
|
|||
|
|
@ -69,12 +69,12 @@ Si vous avez une erreur "(SASL authentication failed; cannot authenticate to ser
|
|||
Vérifier la présence de libsasl2-modules et de sasl2-bin :
|
||||
|
||||
```bash
|
||||
sudo apt-cache search libsasl2-modules
|
||||
sudo apt-cache search sasl2-bin
|
||||
apt search libsasl2-modules
|
||||
apt search sasl2-bin
|
||||
```
|
||||
|
||||
Si ils ne sont pas présents, installez-les :
|
||||
|
||||
```bash
|
||||
sudo apt-get install libsasl2-modules sasl2-bin
|
||||
apt install libsasl2-modules sasl2-bin
|
||||
```
|
||||
|
|
|
|||
59
jessie_stretch_migration.md
Normal file
59
jessie_stretch_migration.md
Normal file
|
|
@ -0,0 +1,59 @@
|
|||
# Migrating an existing instance to Stretch
|
||||
|
||||
This page is dedicated to help you migrating an instance from YunoHost 2.7.x (running on Debian Jessie/8.x) to YunoHost 3.0 (running on Debian Stretch/9.x).
|
||||
|
||||
## Important notes
|
||||
|
||||
- The YunoHost team did its best to make sure that the migration is as smooth as possible and was tested over the course of several months in several cases.
|
||||
|
||||
- With that said, please be aware that this is a delicate operation. System administration is a complicated topic and covering every particular cases is quite hard. Therefore, if you host critical data and services, please [make backups](/backup). And in any case, be patient and attentive during the migration.
|
||||
|
||||
- Yet, please don't rush into thinking that you should rush into reinstalling your system. A common "mistake" is to be willing to reinstall a server at the slightest complication. But turns out that reinstalling a system can also be complicated. Instead, if you happen to run into issues, we encourage you to try to investigate and understand what's going on and reach for help instead of just throwing away everything because it looks simpler.
|
||||
|
||||
- About external email clients : if you or your users are using external email clients (typically Thunderbird, K9Mail, ...) be aware that the SMTP port changed from 465 (with SSL/TLS) to 587 (STARTTLS). See [this page of doc dedicated to email clients](/email_configure_client).
|
||||
|
||||
- For advanced users : if you have some custom scripts for backups, be aware that we made some backward-incompatible changes in the backup command line. The deprecated `--hooks`/`--ignore-hooks` options were removed, as well as the options `--ignore-apps`, `--ignore-system`. To make things more intuitive, `yunohost backup create --apps wordpress` (for example) will only backup wordpress, i.e. you don't have to add `--ignore-system` to not backup the system.
|
||||
|
||||
## Migration procedure
|
||||
|
||||
#### From the webadmin
|
||||
|
||||
After upgrading to 2.7.14, go to Tools > Migrations to access the migrations interface. You will have to read carefully and accept the disclaimer then launch the migration. The logs will be shown in the message bar (you can hover it to see the whole history).
|
||||
|
||||
#### From the command line
|
||||
|
||||
After upgrading to 2.7.14, run :
|
||||
|
||||
```bash
|
||||
yunohost tools migrations migrate
|
||||
```
|
||||
|
||||
then read carefully and accept the disclaimer.
|
||||
|
||||
## During the migration
|
||||
|
||||
Depending on your hardware and packages installed, the migration might take up to a few hours.
|
||||
|
||||
Note that it is expected to see some errors (in particular about fail2ban) during the migration, so don't worry too much about them.
|
||||
|
||||
#### If the migration crashed / failed at some point.
|
||||
|
||||
If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you tell that it's not working).
|
||||
|
||||
## What to do after the upgrade
|
||||
|
||||
#### Check that you actually are on Debian Stretch and YunoHost 3.0
|
||||
|
||||
You should be able to see this from the webadmin Tools > Diagnosis, and also in the footer of the page. On the command line, you can use `lsb_release -a` and `yunohost --version`.
|
||||
|
||||
#### Check that fail2ban and the firewall are active
|
||||
|
||||
You should be able to see that fail2ban and the firewall are active. From the webadmin in Services (look for 'fail2ban' and 'yunohost-firewall'). From the command line, run `yunohost service status fail2ban yunohost-firewall`. They should both have `active: active`.
|
||||
|
||||
#### Check that your applications are working
|
||||
|
||||
Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway).
|
||||
|
||||
#### Mail users: check your mail score
|
||||
|
||||
If you are using mails (especially sending them), check that your score is still good by using [mail-tester](https://www.mail-tester.com/) for example.
|
||||
59
jessie_stretch_migration_fr.md
Normal file
59
jessie_stretch_migration_fr.md
Normal file
|
|
@ -0,0 +1,59 @@
|
|||
# Migrer vers Stretch
|
||||
|
||||
L'objectif cette page est de décrire le processus de migration d'une instance en YunoHost 2.7.x (tournant sous Debian Jessie/8.x) vers YunoHost 3.0 (tournant sous Debian Stretch/9.x)
|
||||
|
||||
## Notes importantes
|
||||
|
||||
- L'équipe de YunoHost a fait de son mieux pour que cette migration se passe autant en douceur que possible. Elle a été testée durant plusieurs mois et sur plusieurs types d'installations.
|
||||
|
||||
- Néanmoins, vous devez être conscient qu'il s'agit d'une opération délicate. L'administration système est un sujet compliqué et couvrir tous les cas particuliers n'est pas chose aisée. En conséquence, si vous hébergez des données et des systèmes critiques, [faites des sauvegardes](/backup). Et dans tous les cas, soyez patients et attentifs durant la migration.
|
||||
|
||||
- Cependant, ne vous précipitez pas non plus à vouloir faire une réinstallation de votre système. Une attitude qui revient réguliement est de vouloir réinstaller son système à la moindre complication. Pourtant, réinstaller peut aussi s'avérer compliqué. À la place, si vous rencontrez des problèmes, nous vous encourageons à investiguer, chercher à comprendre et trouver de l'aide, plutôt que de se précipiter à vouloir réinstaller simplement parce que cela semble plus simple.
|
||||
|
||||
- Si vous ou vos utilisateurs utilisez des clients emails externes (typiquement Thunderbird ou K9Mail) : le port SMTP a changé. Il s'agissait auparavant du port 465 (avec SSL/TLS) qui a été remplacé par 587 (STARTTLS). Voir [cette page de doc dédiée à la configuration des clients mails](/email_configure_client).
|
||||
|
||||
- Pour les utilisateurs avancés : si vous avez des scripts personnels pour faire des backups, certains changements cassent (de façon mineure) la rétrocompatibilité de la ligne de commande. Les options dépréciées `--hooks`/`--ignore-hooks` ont été enlevées, ainsi que `--ignore-apps`, `--ignore-system`. Pour rendre les choses plus intuitives, `yunohost backup create --apps wordpress` (par exemple) créera uniquement un backup de wordpress, i.e. pas besoin d'ajouter `--ignore-system` pour ne pas backuper le système.
|
||||
|
||||
## Procédure de migration
|
||||
|
||||
#### Depuis la webadmin
|
||||
|
||||
Après avoir mis à jour vers la version 2.7.14, allez dans Outils > Migrations pour accéder à l'interface de migration. Il vous faudra ensuite lire l'avertissement attentivement et l'accepter pour lancer la migration. Les logs seront affichés dans la barre de message en haut (vous pouvez approcer la souris dessus pour voir l'historique en entier).
|
||||
|
||||
#### Depuis la ligne de commande
|
||||
|
||||
Après avoir mis à jour vers la version 2.7.14, lancez :
|
||||
|
||||
```bash
|
||||
yunohost tools migrations migrate
|
||||
```
|
||||
|
||||
puis lisez attentivement l'averissement et les instructions.
|
||||
|
||||
## Pendant la migration
|
||||
|
||||
En fonction de votre matériel et des paquets installés, la migration peut prendre jusqu'à quelques heures.
|
||||
|
||||
Notez qu'il est attendu de voir certaines erreurs (en particulier à propos de fail2ban) pendant la migration - ne vous en inquiétez pas trop.
|
||||
|
||||
#### Si la migration a crashé / échoué à un moment.
|
||||
|
||||
Si la migration a échoué a un moment donné, la première chose à faire est de tenter de la relancer. Si cela ne fonctionne toujours pas, il vous faut [trouver de l'aide](/help) (prière de fournir le/les messages correspondants ou tout élément qui vous fait penser que ça n'a pas marché).
|
||||
|
||||
## Choses à vérifier après la migration
|
||||
|
||||
#### Vérifiez que vous êtes véritablement sous Debian Stretch / YunoHost 3.0
|
||||
|
||||
Pour cela, allezdans Outils > Diagnostique. (Vous pouvez aussi regarder ce qui est affiché dans le pied de page). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`.
|
||||
|
||||
#### Vérifiez que fail2ban et le pare-feu sont actifs.
|
||||
|
||||
Vous devriez voir que fail2ban et le firewall sont actifs. Depuis la webadmin, dans Services (chercher 'fail2ban' et 'yunohost-firewall'). Depuis la ligne de commande, faites `yunohost service status fail2ban yunohost-firewall` : les deux devraient être en `active: active`.
|
||||
|
||||
#### Vérifiez que les applications fonctionnent
|
||||
|
||||
Vérifiez que vos applications installées fonctionnent... Si elles ne fonctionnent pas, il est recommandé de tenter de les mettre à jour. (ou bien de manière générale, il est recommandé de les mettre à jour même si elles fonctionnent !).
|
||||
|
||||
#### Si vous utilisez les mails : vérifiez votre score
|
||||
|
||||
Si vous utilisez les emails (en particulier les envois), vérifiez que votre score est toujours bon via [mail-tester](https://www.mail-tester.com/) par exemple.
|
||||
|
|
@ -70,7 +70,7 @@ Here is a list of best practices for application install scripts:
|
|||
* install script should use the command-line method instead of calls to curl through web install form;
|
||||
* install script should save install answers;
|
||||
* application sources should be checked with a control sum (sha256, sha1 or md5) or a PGP signature;
|
||||
* scripts should be tested on Debian Jessie as well as 32 bits, 64 bits and ARM architectures;
|
||||
* scripts should be tested on Debian Stretch 32 bits, 64 bits and ARM architectures;
|
||||
* backup and restore scripts should be present and functional.
|
||||
|
||||
To be define the quality of a package, it'll obtained a [level](packaging_apps_levels_fr), determined according to somes criteria of installation and according to respect to [package guidelines](packaging_apps_guidelines_fr).
|
||||
|
|
@ -92,4 +92,4 @@ This Python script checks:
|
|||
- Subscribe to the [Apps mailing list](https://list.yunohost.org/cgi-bin/mailman/listinfo/apps) to be informed about packaging evolution.
|
||||
|
||||
### Officalization of an application
|
||||
To become an official application, it must be tested well enough, be stable and should work on 64 bits, 32 bits et ARM processor architectures, and on Debian Jessie. If you think those conditions are met, ask for [official integration](https://github.com/YunoHost/apps) of your application.
|
||||
To become an official application, it must be tested well enough, be stable and should work on Debian Stretch 64 bits, 32 bits and ARM architectures. If you think those conditions are met, ask for [official integration](https://github.com/YunoHost/apps) of your application.
|
||||
|
|
|
|||
|
|
@ -52,7 +52,7 @@ Vous trouverez ci-dessous une liste des points à vérifier concernant la qualit
|
|||
* Votre script d’installation utilise une méthode d’installation en ligne de commande plutôt qu’un appel curl via un formulaire web d’installation ;
|
||||
* Votre script d’installation enregistre les réponses de l’utilisateur ;
|
||||
* Vous avez vérifié les sources de l’application avec une somme de contrôle (sha256, sha1 ou md5) ou une signature PGP ;
|
||||
* Vos scripts ont été testés sur Debian Jessie ainsi que sur les architectures 32 bits, 64 bits et ARM ;
|
||||
* Vos scripts ont été testés sur Debian Stretch 32 bits, 64 bits et ARM ;
|
||||
* Les scripts backup et restore sont présents et fonctionnels.
|
||||
|
||||
Pour mesurer la qualité d'un paquet, celui-ci obtiendra un [niveau](packaging_apps_levels_fr), déterminé en fonction de divers critères d'installation et selon le respect des [règles de packaging](packaging_apps_guidelines_fr).
|
||||
|
|
@ -74,4 +74,4 @@ Il s’agit d’un script Python qui vérifie :
|
|||
- Inscrivez-vous à la [mailing list Apps](https://list.yunohost.org/cgi-bin/mailman/listinfo/apps) pour être tenu au courant des évolutions du packaging.
|
||||
|
||||
### Officialisation d’une application
|
||||
Pour qu’une application devienne officielle, elle doit être suffisamment testée, stable et fonctionner sous les architectures 64 bits, 32 bits et ARM sur Debian Jessie. Si ces conditions vous paraissent réunies, demandez l’[intégration officielle](https://github.com/YunoHost/apps) de votre application.
|
||||
Pour qu’une application devienne officielle, elle doit être suffisamment testée, stable et fonctionner sous Debian Stretch 64 bits, 32 bits et ARM. Si ces conditions vous paraissent réunies, demandez l’[intégration officielle](https://github.com/YunoHost/apps) de votre application.
|
||||
|
|
|
|||
|
|
@ -48,7 +48,6 @@ Services pris en charge par regen-conf:
|
|||
- nslcd
|
||||
- nsswitch
|
||||
- postfix
|
||||
- rmilter
|
||||
- rspamd
|
||||
- slapd
|
||||
- ssh
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ See https://www.torproject.org/docs/tor-hidden-service.html.en
|
|||
|
||||
### Installing Tor
|
||||
```bash
|
||||
sudo apt-get install tor
|
||||
apt install tor
|
||||
```
|
||||
|
||||
### Configuring our hidden service
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ Voir https://www.torproject.org/docs/tor-hidden-service.html.en (anglais)
|
|||
|
||||
### Installer Tor
|
||||
```bash
|
||||
sudo apt-get install tor
|
||||
apt install tor
|
||||
```
|
||||
|
||||
### Configurer notre service caché
|
||||
|
|
|
|||
|
|
@ -27,13 +27,13 @@ Problems often occur after an upgrade. After a YunoHost upgrade you may want to
|
|||
|
||||
You are probably familiar with:
|
||||
```bash
|
||||
sudo apt-get update && sudo apt-get dist-upgrade
|
||||
$ apt update && apt dist-upgrade
|
||||
```
|
||||
Most of the time it's enough. But in some cases it's possible that some process are still using old versions of upgraded files (such as libraries), that can cause bug. In rare cases that can lead to security concern (ex: upgrade OpenSSL because of a security bug, Nginx will continue to use the version it has in memory). The utility Checkrestart will help you to find and restart them.
|
||||
|
||||
```bash
|
||||
sudo apt-get install debian-goodies
|
||||
sudo checkrestart
|
||||
$ apt install debian-goodies
|
||||
$ checkrestart
|
||||
Found 0 processes using old versions of upgraded files
|
||||
```
|
||||
If some process are running with old librairies versions checkrestart will tell you and propose you a way to restart them. In some cases checkrestart can't find a way to restart them.
|
||||
|
|
@ -48,10 +48,10 @@ You can also use [this script](https://github.com/octopuce/octopuce-goodies/blob
|
|||
|
||||
/!\ Always check if there is a upgrade script and read it if you can /!\
|
||||
```bash
|
||||
sudo yunohost app upgrade
|
||||
$ yunohost app upgrade
|
||||
Warning: You must provide an URL to upgrade your custom app app_name
|
||||
Error: No app to upgrade
|
||||
sudo yunohost app upgrade -u https://github.com/user/someapp_ynh app_name
|
||||
$ yunohost app upgrade -u https://github.com/user/someapp_ynh app_name
|
||||
```
|
||||
|
||||
## Services
|
||||
|
|
@ -61,7 +61,7 @@ YunoHost uses a bunch of software to accomplish its purpose. Most of theses soft
|
|||
When something doesn't work on your YunoHost, one of the first things to do is to check that all services used by YunoHost are running.
|
||||
YunoHost include a helper to see the status of all services used by YunoHost:
|
||||
```bash
|
||||
sudo yunohost service status
|
||||
$ yunohost service status
|
||||
```
|
||||
|
||||
Sample result:
|
||||
|
|
@ -89,24 +89,22 @@ All services should be enabled and running. Except glances (optional). If some a
|
|||
Others services installed by applications can also be present. For instance, `seafile-serve` which serves Seafile app and `uwsgi` which serve Python apps such as Searx.
|
||||
|
||||
##### Start or stop a service which is registered with YunoHost:
|
||||
|
||||
```bash
|
||||
sudo yunohost service start <servicename>
|
||||
sudo yunohost service stop <servicename>
|
||||
$ yunohost service start <servicename>
|
||||
$ yunohost service stop <servicename>
|
||||
```
|
||||
You can also use the generic Debian command:
|
||||
```bash
|
||||
sudo service <servicename> start/stop/restart/reload
|
||||
$ systemctl start/stop/restart/reload <servicename>
|
||||
```
|
||||
After a launch attempt, always check that the service is running.
|
||||
|
||||
**Note**: Debian Jessie now uses `systemd` instead of `upstart`, but, for now it's fully compatible with Debian Wheezy way to handle services. [Useful resource on systemd](https://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet).
|
||||
|
||||
### Logs
|
||||
If a service won't start you have to check the logs to see what's wrong. There is no generic way for services to store their logs, but there are mainly stocked in:
|
||||
```bash
|
||||
/var/log/
|
||||
```
|
||||
If a service won't start you have to check the logs to see what's wrong. There is no generic way for services to store their logs, but there are mainly stocked in: `/var/log/`
|
||||
|
||||
Here are the some useful logs files for YunoHost:
|
||||
|
||||
##### auth.log
|
||||
Contains connections or attempt of connection to your server. It includes every web, ssh, cron job connection. It also stockes all the failed (hopefully) attempts to connect by a potential intruders connections.
|
||||
|
||||
|
|
@ -122,7 +120,7 @@ XMPP chat server logs.
|
|||
##### mysql.err, mysql.log, mysql/error.log
|
||||
MySQL database logs, these should be empty unless you have trouble with MySQL.
|
||||
|
||||
##### php5-fpm.log
|
||||
##### php7.0-fpm.log
|
||||
Generic logs for PHP apps.
|
||||
|
||||
##### yunohost.log
|
||||
|
|
@ -228,7 +226,7 @@ You can view (don't edit it, it is oftently overwritten) your current SSOwat con
|
|||
```
|
||||
Which is generated with the command:
|
||||
```bash
|
||||
sudo yunohost app ssowatconf
|
||||
yunohost app ssowatconf
|
||||
```
|
||||
Protip: if you want to add a personalized rule for SSOwat, do it in this file:
|
||||
```bash
|
||||
|
|
@ -265,7 +263,7 @@ In each app packages you will find:
|
|||
* **config/**: config directory
|
||||
* **settings.yml**: config of the app, also accessible with:
|
||||
```bash
|
||||
sudo yunohost app setting appname settingname
|
||||
yunohost app setting appname settingname
|
||||
```
|
||||
|
||||
### Logs
|
||||
|
|
|
|||
|
|
@ -28,15 +28,15 @@ Les problèmes ont souvent lieu après une mise à jour. Après une mise à jour
|
|||
**Vérifier si un processus utilise une ancienne librairie**
|
||||
vous avez sûrement l’habitude d’utiliser :
|
||||
```bash
|
||||
sudo apt-get update && sudo apt-get dist-upgrade
|
||||
$ apt update && apt dist-upgrade
|
||||
```
|
||||
La plupart du temps, cela suffit. Mais dans certaines situations, il est possible que certains processus utilisent toujours d’anciennes bibliothèques non mises à jour.
|
||||
Cela peut entraîner des bugs et, dans certains rares cas, des problèmes de sécurité (ex : lors d’une mise à jour de OpenSSL à cause d’une faille de sécurité, Nginx va continuer à utiliser la version dont il dispose en mémoire). L’utilitaire Checkrestart va vous aider à identifier ces processus et les redémarrer.
|
||||
|
||||
```bash
|
||||
sudo apt-get install debian-goodies
|
||||
sudo checkrestart
|
||||
Found 0 processes using old versions of upgraded files
|
||||
$ apt install debian-goodies
|
||||
checkrestart
|
||||
# Found 0 processes using old versions of upgraded files
|
||||
```
|
||||
Si des processus fonctionnent avec des vieilles versions de bibliothèques, checkrestart va vous le dire et vous proposer une manière de les redémarrer. Il est possible que checkrestart ne trouve pas de manière de les redémarrer. Attention, il faut opérer l’opération manuellement.
|
||||
|
||||
|
|
@ -52,10 +52,11 @@ Vous pouvez aussi utiliser [ce script](https://github.com/octopuce/octopuce-good
|
|||
|
||||
|
||||
```bash
|
||||
sudo yunohost app upgrade
|
||||
$ yunohost app upgrade
|
||||
Warning: You must provide an URL to upgrade your custom app app_name
|
||||
Error: No app to upgrade
|
||||
sudo yunohost app upgrade -u https://github.com/user/someapp_ynh app_name
|
||||
|
||||
$ yunohost app upgrade -u https://github.com/user/someapp_ynh app_name
|
||||
```
|
||||
|
||||
## Les services
|
||||
|
|
@ -65,7 +66,7 @@ YunoHost utilise toute une série de logiciels pour fonctionner. La plupart de c
|
|||
Quand quelque chose ne fonctionne pas, une des premières choses à faire est de vérifier que tous les services utilisés par YunoHost sont lancés.
|
||||
YunoHost inclus un outil qui permet de visualiser tous les services utilisés par YunoHost :
|
||||
```bash
|
||||
sudo yunohost service status
|
||||
yunohost service status
|
||||
```
|
||||
Exemple de résultat :
|
||||
|
||||
|
|
@ -94,16 +95,14 @@ Voici une petite description de leurs fonctions respectives :
|
|||
Les autres services installés par des applications vont aussi apparaître. Par exemple `seafile-serve` utilisé par l’application Seafile et `uwsgi` qui est utilisé par des applications python comme Searx.
|
||||
##### démarrer ou arrêter un service identifié avec YunoHost :
|
||||
```bash
|
||||
sudo yunohost service start <servicename>
|
||||
sudo yunohost service stop <servicename>
|
||||
yunohost service start <servicename>
|
||||
yunohost service stop <servicename>
|
||||
```
|
||||
Vous pouvez aussi utiliser la commande Debian :
|
||||
```bash
|
||||
sudo service <servicename> start/stop/restart/reload
|
||||
systemctl start/stop/restart/reload <servicename>
|
||||
```
|
||||
Après une tentative de lancement, vérifiez toujours que le service est lancé.
|
||||
**Note** : Debian Jessie utilise désormais `systemd` à la place de `upstart`. Cela est pour l’instant toujours compatible avec la manière dont Debian Wheezy gère les services.
|
||||
[Ressources utiles sur systemd](https://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet).
|
||||
|
||||
### Logs
|
||||
Si un service ne démarre pas, vous devez vérifier les logs pour voir ce qui ne pose problème. Il n’y a pas de règles définies où les services doivent stocker leurs logs. Cependant, ceux-ci se trouvent pour la plupart dans :
|
||||
|
|
@ -126,7 +125,7 @@ Logs du serveur de chat XMPP
|
|||
##### mysql.err, mysql.log, mysql/error.log
|
||||
Logs de la base de données MySQL. Ils doivent être vides sauf si vous avez des problèmes avec MySQL.
|
||||
|
||||
##### php5-fpm.log
|
||||
##### php7.0-fpm.log
|
||||
Lieu générique d’emplacement des logs pour les applications PHP.
|
||||
|
||||
##### yunohost.log
|
||||
|
|
|
|||
11
vagrant.md
11
vagrant.md
|
|
@ -18,14 +18,11 @@ mkdir YunoHost
|
|||
cd YunoHost
|
||||
```
|
||||
|
||||
The following command will initialize the project with a Yunohost image based on Debian Jessie
|
||||
The following command will initialize the project with a Yunohost image
|
||||
```bash
|
||||
vagrant box add yunohost/jessie-stable https://build.yunohost.org/yunohost-jessie-stable.box --provider virtualbox
|
||||
vagrant init yunohost/jessie-stable
|
||||
vagrant box add yunohost/stretch-unstable https://build.yunohost.org/yunohost-stretch-unstable.box --provider virtualbox
|
||||
vagrant init yunohost/stretch-unstable
|
||||
```
|
||||
<blockquote>
|
||||
<span class="text-warning">/!\</span> If you prefer use the beta version : https://build.yunohost.org/yunohost-jessie-testing.box
|
||||
</blockquote>
|
||||
|
||||
You need to activate the network for the YunoHost instance.
|
||||
```bash
|
||||
|
|
@ -47,7 +44,7 @@ vagrant ssh
|
|||
|
||||
Upgrade the system
|
||||
```bash
|
||||
sudo apt-get update && sudo apt-get dist-upgrade
|
||||
apt update && apt dist-upgrade
|
||||
```
|
||||
|
||||
You can access to your vm with the ip 192.168.33.10
|
||||
|
|
|
|||
|
|
@ -20,13 +20,9 @@ cd YunoHost
|
|||
|
||||
La commande suivante va initialiser le projet avec une image YunoHost de base
|
||||
```bash
|
||||
vagrant box add yunohost/jessie-stable https://build.yunohost.org/yunohost-jessie-stable.box --provider virtualbox
|
||||
vagrant init yunohost/jessie-stable
|
||||
vagrant box add yunohost/stretch-unstable https://build.yunohost.org/yunohost-stretch-unstable.box --provider virtualbox
|
||||
vagrant init yunohost/stretch-unstable
|
||||
```
|
||||
<blockquote>
|
||||
<span class="text-warning">/!\</span>Si vous préférez utiliser la version beta https://build.yunohost.org/yunohost-jessie-testing.box
|
||||
</blockquote>
|
||||
|
||||
Puis, il faut activer le réseau pour l'instance YunoHost:
|
||||
```bash
|
||||
sed -i 's/# config\.vm\.network "private_network"/config.vm.network "private_network"/' Vagrantfile
|
||||
|
|
@ -48,7 +44,7 @@ vagrant ssh
|
|||
|
||||
Mettre à jour le système.
|
||||
```bash
|
||||
sudo apt-get update && sudo apt-get dist-upgrade
|
||||
apt update && apt dist-upgrade
|
||||
```
|
||||
|
||||
Vous pouvez accéder à votre vm via l’ip 192.168.33.10.
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue