YunoHost-Apps/mastodon_ynh
1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/mastodon_ynh.git synced 2024-09-03 19:46:02 +02:00
Code Issues Activity Actions

break lines

Browse source
This commit is contained in:
OniriCorpe 2024-02-24 22:34:08 +01:00
parent 2caac6bef0
commit 27526bd2cb
3 changed files with 18 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
doc/ADMIN.md
View file

@ -4,7 +4,7 @@
## Update ## Update
**`screen` (or `tmux`) can be used to make sure your session is not interrupted in case of connection problems.** **`screen` (or `tmux`) can be used to make sure your session is not interrupted in case of connection problems.**
See [tutorial](https://www.howtogeek.com/662422/how-to-use-linuxs-screen-command/) for more background information. See [tutorial](https://www.howtogeek.com/662422/how-to-use-linuxs-screen-command/) for more background information.
```bash ```bash
@ -14,7 +14,7 @@ sudo yunohost app upgrade mastodon
## Backups ## Backups
First of all: Mastodon uses a local cache to save media (such as posted images, videos etc.). This cache can grow huge. First of all: Mastodon uses a local cache to save media (such as posted images, videos etc.). This cache can grow huge.
You could consider cleaning up your local cache first as otherwise your backup will be very big and you might run out of disk space: You could consider cleaning up your local cache first as otherwise your backup will be very big and you might run out of disk space:
To check your space usage, on a command line run: To check your space usage, on a command line run:
@ -23,7 +23,9 @@ To check your space usage, on a command line run:
sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media usage sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media usage
``` ```
If your cache is too big to backup, you can run the following command to clean up Attachments (the first line). Substitute X by the number of days you want to keep, e.g. 1 day. All older images will be deleted but will be refetched from the original server if necessary. If your cache is too big to backup, you can run the following command to clean up Attachments (the first line).
Substitute X by the number of days you want to keep, e.g. 1 day.
All older images will be deleted but will be refetched from the original server if necessary.
First dry-run to see how much space is freed up (without actually removing): First dry-run to see how much space is freed up (without actually removing):
@ -44,9 +46,9 @@ Check [the official documentation](https://docs.joinmastodon.org/admin/tootctl/#
Before definitively uninstalling Mastodon, you have to run `tootctl self-destruct` to broadcast your users and instance deletion to the federation. Before definitively uninstalling Mastodon, you have to run `tootctl self-destruct` to broadcast your users and instance deletion to the federation.
Otherwise your data will remain in federation cache for ever. Otherwise your data will remain in federation cache for ever.
⚠️ Make sure you know exactly what you are doing before running this command. ⚠️ Make sure you know exactly what you are doing before running this command.
⚠️ This operation is NOT reversible, and it can take a long time. ⚠️ This operation is NOT reversible, and it can take a long time.
⚠️ The server will be in a BROKEN STATE after this command finishes. ⚠️ The server will be in a BROKEN STATE after this command finishes.
⚠️ A running Sidekiq process is required, so do not shut down the server until the queues are fully cleared. ⚠️ A running Sidekiq process is required, so do not shut down the server until the queues are fully cleared.
```bash ```bash

14
doc/ADMIN_fr.md
View file

@ -4,7 +4,7 @@
## Mise à jour ## Mise à jour
**`screen` (ou `tmux`) peut être utilisé pour vous assurer que votre session n'est pas interrompue en cas de problème de connection.** **`screen` (ou `tmux`) peut être utilisé pour vous assurer que votre session n'est pas interrompue en cas de problème de connection.**
Consultez ce [tutoriel](https://www.howtogeek.com/662422/how-to-use-linuxs-screen-command/) pour plus de détails. Consultez ce [tutoriel](https://www.howtogeek.com/662422/how-to-use-linuxs-screen-command/) pour plus de détails.
```bash ```bash
@ -14,7 +14,7 @@ sudo yunohost app upgrade mastodon
## Sauvegardes ## Sauvegardes
Tout d'abord : Mastodon utilise un cache local pour sauvegarder les médias (comme les images, vidéos, etc). Ce cache peut devenir énorme. Tout d'abord : Mastodon utilise un cache local pour sauvegarder les médias (comme les images, vidéos, etc). Ce cache peut devenir énorme.
Vous devriez réfléchir à vider votre cache local avant de faire une sauvegarde, qui pourrait être énorme et vous pourriez manquer d'espace de stockage. Vous devriez réfléchir à vider votre cache local avant de faire une sauvegarde, qui pourrait être énorme et vous pourriez manquer d'espace de stockage.
Pour vérifier l'utilisation du stockage, en ligne de commande utilisez : Pour vérifier l'utilisation du stockage, en ligne de commande utilisez :
@ -23,7 +23,9 @@ Pour vérifier l'utilisation du stockage, en ligne de commande utilisez :
sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media usage sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media usage
``` ```
Si le cache est trop gros pour être sauvegardé, vous pouvez lancer la commande suivante pour en supprimer les médias attachés. Changez `X` par le nombre de cache à conserver, par ex. 1 jour. Tous les médias plus anciens seront supprimés, mais ils pourront être rechargé du serveur d'origine si nécessaire. Si le cache est trop gros pour être sauvegardé, vous pouvez lancer la commande suivante pour en supprimer les médias attachés.
Changez `X` par le nombre de cache à conserver, par ex. 1 jour.
Tous les médias plus anciens seront supprimés, mais ils pourront être rechargé du serveur d'origine si nécessaire.
En premier faite un essai à blanc pour voir combien de place sera libérée (sans rien supprimer): En premier faite un essai à blanc pour voir combien de place sera libérée (sans rien supprimer):
@ -44,9 +46,9 @@ Consulter [la documentation officielle](<https://docs.joinmastodon.org/admin/too
Avant de désinstaller définitivement Mastodon, vous devez lancer `tootctl self-destruct` pour annoncer à la fédération la suppression de vos utilisateurs et de votre instance. Avant de désinstaller définitivement Mastodon, vous devez lancer `tootctl self-destruct` pour annoncer à la fédération la suppression de vos utilisateurs et de votre instance.
Sinon, vos données resteront dans le cache de la fédération pour toujours. Sinon, vos données resteront dans le cache de la fédération pour toujours.
⚠️ Assurez-vous de savoir exactement ce que vous faites avant d'exécuter cette commande. ⚠️ Assurez-vous de savoir exactement ce que vous faites avant d'exécuter cette commande.
⚠️ Cette opération n'est PAS réversible et peut prendre beaucoup de temps. ⚠️ Cette opération n'est PAS réversible et peut prendre beaucoup de temps.
⚠️ Le serveur sera dans un ÉTAT BRISÉ après la fin de cette commande. ⚠️ Le serveur sera dans un ÉTAT BRISÉ après la fin de cette commande.
⚠️Un processus Sidekiq en cours d'exécution est nécessaire, donc n'arrêtez pas le serveur avant que les files d'attente ne soient complètement vidées. ⚠️Un processus Sidekiq en cours d'exécution est nécessaire, donc n'arrêtez pas le serveur avant que les files d'attente ne soient complètement vidées.
```bash ```bash

3
doc/PRE_INSTALL_fr.md
View file

@ -6,7 +6,8 @@
## Utilisation de *screen* en cas de déconnexion ## Utilisation de *screen* en cas de déconnexion
L'installation de Mastodon peut être longue, selon les performances du serveur. Pour éviter que le processus soit interrompu par une déconnexion, on peut utiliser `screen`. L'installation de Mastodon peut être longue, selon les performances du serveur.
Pour éviter que le processus soit interrompu par une déconnexion, on peut utiliser `screen`.
```bash ```bash
sudo apt install screen sudo apt install screen