From 41cd265505e67caa7bf7da5bdeeab06ea60c1f32 Mon Sep 17 00:00:00 2001 From: panomaki Date: Tue, 4 Apr 2023 19:57:21 +0200 Subject: Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.md') diff --git a/README.md b/README.md index 795d8e5..d9832d6 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/in Mastodon is a free, open-source microblogging social network. It is a decentralized alternative to commercial platforms like Twitter and avoids the risks of a single company monopolizing your communication for commercial purposes. -**Shipped version:** 4.0.2~ynh2 +**Shipped version:** 4.1.2~ynh1 **Demo:** https://joinmastodon.org/ -- cgit v1.2.3-70-g09d2 From 21a9f171b83de4bc8cace4f41c81b28f7661deac Mon Sep 17 00:00:00 2001 From: panomaki Date: Wed, 12 Apr 2023 11:29:34 +0200 Subject: Update README.md --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index d9832d6..138b62e 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,22 @@ $ screen -r `$ 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: + +Mastodon can grow huge. You could consider cleaning up your local cache first as otherwise your backup will be very big: +'sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media remove --days=0 --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=0' + +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)` -- cgit v1.2.3-70-g09d2 From 30f48695dae1594af4ad43a081fe5387378e70ce Mon Sep 17 00:00:00 2001 From: panomaki Date: Wed, 12 Apr 2023 11:30:43 +0200 Subject: Update README.md --- README.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 138b62e..fc27836 100644 --- a/README.md +++ b/README.md @@ -60,9 +60,12 @@ $ screen -r Upgrading from 3.5.3 to 4.1.2 directly has not been integration-tested. It is recommended to do a two-step upgrade: Mastodon can grow huge. You could consider cleaning up your local cache first as otherwise your backup will be very big: -'sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media remove --days=0 --dry-run' + +`$ sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media remove --days=0 --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=0' + +`$ sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media remove --days=0 ` First upgrade to 4.0.2~ynh2: -- cgit v1.2.3-70-g09d2 From 736ca816d7e4778e2510bce0eb74892a857df6c4 Mon Sep 17 00:00:00 2001 From: panomaki Date: Thu, 13 Apr 2023 13:23:46 +0200 Subject: Update README.md Added extra explanations. --- README.md | 28 ++++++++++++++++++++++------ 1 file changed, 22 insertions(+), 6 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index fc27836..0773938 100644 --- a/README.md +++ b/README.md @@ -53,19 +53,35 @@ $ screen -r ### Update -#### Using *screen* highly recommended +##### Please use screen as the upgrade process can take a long time! -`$ sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh --debug ` +#### A note about backups -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 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: -Mastodon can grow huge. You could consider cleaning up your local cache first as otherwise your backup will be very big: +`$ 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 remove --days=0 --dry-run` +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=0 ` +`$ 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: + +`$ 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: -- cgit v1.2.3-70-g09d2 From 28593d50084cd9b865df7648cb23d5bc636373f8 Mon Sep 17 00:00:00 2001 From: panomaki Date: Thu, 13 Apr 2023 16:45:56 +0200 Subject: Update README.md Extra sentence and link to screen tutorial. --- README.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 0773938..40e405e 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,10 @@ 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 -- cgit v1.2.3-70-g09d2 From d5acfd722de0c944ce53fc2fd91efb9474d59fef Mon Sep 17 00:00:00 2001 From: yunohost-bot Date: Fri, 14 Apr 2023 09:23:33 +0000 Subject: Auto-update README --- README.md | 41 +---------------------------------------- README_fr.md | 45 +++++++-------------------------------------- 2 files changed, 8 insertions(+), 78 deletions(-) (limited to 'README.md') 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: - -`$ 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: +#### Using *screen* highly recommended `$ 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 -- cgit v1.2.3-70-g09d2