diff --git a/README.md b/README.md index 40e405e..d9832d6 100644 --- a/README.md +++ b/README.md @@ -40,10 +40,6 @@ Mastodon is a free, open-source microblogging social network. It is a decentrali ### Install #### Using *screen* in case of disconnect - -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. - ``` $ sudo apt-get install screen $ screen @@ -57,45 +53,10 @@ $ screen -r ### Update -##### Please use screen as the upgrade process can take a long time! - -#### A note about backups - -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: - -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` - -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): - -`$ sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media remove --days=X --dry-run` - -If all looks good commit the cleanup: - -`$ sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media remove --days=X ` - -##### Upgrade - -The actual upgrade can be done using the following command: +#### Using *screen* highly recommended `$ sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh --debug ` - -Upgrading from 3.5.3 to 4.1.2 directly has not been integration-tested. It is recommended to do a two-step upgrade: - -First upgrade to 4.0.2~ynh2: - -`$ sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh/tree/94381183ca2d14da72234b53c9a83972ffb16e54 --debug ` - -Check your installation. If all looks well, upgrade to 4.1.2~ynh1: - -`$ sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh --debug ` - - ### Administrate with tooctl `$ (cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl --help)` diff --git a/README_fr.md b/README_fr.md index 3d52153..98f83f1 100644 --- a/README_fr.md +++ b/README_fr.md @@ -36,15 +36,15 @@ Mastodon est un réseau social de microblog auto-hébergé et open source. C'est 1. À la fin de l'installation, un mail est envoyé à cet utilisateur avec un mot de passe généré automatiquement. 1. Pour que votre instance Mastodon reste privée, il est important de fermer les inscriptions. Nous vous invitons à bloquer les instances distantes indésirables depuis l'interface d'administration. Vous pouvez également ajouter un texte sur votre page d'accueil dans l'administration. +## Captures d'écran + +![](https://framalibre.org/sites/default/files/mastodon.png) + ## Configuration ### Installation #### Utilisation de *screen* en cas de déconnection - -Screen (or 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. - ``` $ sudo apt-get install screen $ screen @@ -55,42 +55,11 @@ Récupérer l'installation après une deconnection : $ screen -d $ screen -r ``` +L'utilisateur admin est créé automatiquement comme : user@domain.tld ### Mise à jour -**Utilisation de *screen* fortement recommandée** - -### Note à propos des 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. -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 : - -`$ 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. - -En premier faite un essai à blanc pour voir combien de place sera libérée (sans rien supprimer): -`$ sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media remove --days=X --dry-run` - -Si cela semble bon, effectuez le nettoyage : -`$ sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media remove --days=X ` - -##### Upgrade - -La mise à niveau proprement dite peut être effectuée à l'aide de la commande suivante : - -`$ sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh --debug ` - - -Mettre à niveau de 3.5.3 en 4.1.2 directement n'a pas été testé automatiquement. Il est donc recommandé de la réaliser en 2 étapes : - -Mettez d'abord à niveau en 4.0.2~ynh2: - -`$ sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh/tree/94381183ca2d14da72234b53c9a83972ffb16e54 --debug ` - -Vérifiez votre installation. Si cela semble bon, mettez à niveau en 4.1.2~ynh1: +#### Utilisation de *screen* fortement recommandée `$ sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh --debug ` @@ -126,4 +95,4 @@ ou sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing --debug ``` -**Plus d’infos sur le packaging d’applications :** +**Plus d’infos sur le packaging d’applications :** \ No newline at end of file