Auto-update READMEs

README.md

@@ -25,7 +25,7 @@ In addition to taking over the functionality of Instagram, the functioning of Pi
 
 It is also possible to import your data from Instagram. 
 
-**Shipped version:** 0.11.13~ynh1
+**Shipped version:** 0.12.1~ynh1
 
 ## Screenshots
 

README_es.md

@@ -25,12 +25,45 @@ In addition to taking over the functionality of Instagram, the functioning of Pi
 
 It is also possible to import your data from Instagram. 
 
-**Versión actual:** 0.11.13~ynh1
+**Versión actual:** 0.12.1~ynh1
 
 ## Capturas
 
 ![Captura de Pixelfed](./doc/screenshots/screenshots.jpg)
 
+## informaciones importantes
+
+## Some useful commands to know to manage your instance
+You need to run them from you pixelfed folder (usually `/var/www/pixelfed`). The `php.VERSION` might be changed according to you current package version.
+
+### Applying changes from the `.env` config file
+
+Once you made some changes, you need to run `php8.2 artisan config:cache && php8.2 artisan cache:clear` to apply them.
+Note: this will disconnect any logged-in account (including from the admin web UI).
+
+### Removing avatar cache to save space
+`php8.2 artisan avatar:storage-deep-clean`
+
+Use it to prune old avatars that are outdated or no longer used. This might save some disk space.
+
+### Fix missing avatars or refetch them.
+`php8.2 artisan  avatar:storage`
+
+It can be used to fetch remote avatars that are not loaded (or in case you deleted `/var/www/pixelfed/storage/app/public/cache/avatars` where they are stored).
+It might also be usefull to migrate that cache (only, not the other existing media) to an S3 storage, by refectching all of them.
+
+Be aware that this will generate a lot of "jobs" that will take time to be completed, and have a significant load on your server (especially bandwith and CPU).
+
+### When using S3
+
+- Delete non-used media that where not cleaned (it happens) : `php8.2 artisanmedia:gc` (Delete media uploads not attached to any active statuses)
+
+- Same but for media stored on S3 storage and still locally stored (doubles) : `php8.2 artisan media:s3gc` (Delete (local) media uploads that exist on S3)
+
+- Migrate your media to an S3 storage (you need to configure it first), so media uploaded before configuring S3 are migrated there: `php8.2 artisanmedia:migrate2cloud` (Move older media to cloud storage)
+
+- Migrate from one S3 backend the other one (change the configuration first): `php8.2 artisanmedia:cloud-url-rewrite` (Rewrite S3 media urls from local users)
+
 ## Documentaciones y recursos
 
 - Sitio web oficial: <https://pixelfed.org/>

README_eu.md

@@ -25,12 +25,45 @@ In addition to taking over the functionality of Instagram, the functioning of Pi
 
 It is also possible to import your data from Instagram. 
 
-**Paketatutako bertsioa:** 0.11.13~ynh1
+**Paketatutako bertsioa:** 0.12.1~ynh1
 
 ## Pantaila-argazkiak
 
 ![Pixelfed(r)en pantaila-argazkia](./doc/screenshots/screenshots.jpg)
 
+## Ezespena / informazio garrantzitsua
+
+## Some useful commands to know to manage your instance
+You need to run them from you pixelfed folder (usually `/var/www/pixelfed`). The `php.VERSION` might be changed according to you current package version.
+
+### Applying changes from the `.env` config file
+
+Once you made some changes, you need to run `php8.2 artisan config:cache && php8.2 artisan cache:clear` to apply them.
+Note: this will disconnect any logged-in account (including from the admin web UI).
+
+### Removing avatar cache to save space
+`php8.2 artisan avatar:storage-deep-clean`
+
+Use it to prune old avatars that are outdated or no longer used. This might save some disk space.
+
+### Fix missing avatars or refetch them.
+`php8.2 artisan  avatar:storage`
+
+It can be used to fetch remote avatars that are not loaded (or in case you deleted `/var/www/pixelfed/storage/app/public/cache/avatars` where they are stored).
+It might also be usefull to migrate that cache (only, not the other existing media) to an S3 storage, by refectching all of them.
+
+Be aware that this will generate a lot of "jobs" that will take time to be completed, and have a significant load on your server (especially bandwith and CPU).
+
+### When using S3
+
+- Delete non-used media that where not cleaned (it happens) : `php8.2 artisanmedia:gc` (Delete media uploads not attached to any active statuses)
+
+- Same but for media stored on S3 storage and still locally stored (doubles) : `php8.2 artisan media:s3gc` (Delete (local) media uploads that exist on S3)
+
+- Migrate your media to an S3 storage (you need to configure it first), so media uploaded before configuring S3 are migrated there: `php8.2 artisanmedia:migrate2cloud` (Move older media to cloud storage)
+
+- Migrate from one S3 backend the other one (change the configuration first): `php8.2 artisanmedia:cloud-url-rewrite` (Rewrite S3 media urls from local users)
+
 ## Dokumentazioa eta baliabideak
 
 - Aplikazioaren webgune ofiziala: <https://pixelfed.org/>

README_fr.md

@@ -26,7 +26,7 @@ En plus de reprendre les fonctionnalités d'Instagram, le fonctionnement de Pixe
 Il est également possible d'importer ses données depuis Instagram.
 
 
-**Version incluse :** 0.11.13~ynh1
+**Version incluse :** 0.12.1~ynh1
 
 ## Captures d’écran
 

README_gl.md

@@ -25,12 +25,45 @@ In addition to taking over the functionality of Instagram, the functioning of Pi
 
 It is also possible to import your data from Instagram. 
 
-**Versión proporcionada:** 0.11.13~ynh1
+**Versión proporcionada:** 0.12.1~ynh1
 
 ## Capturas de pantalla
 
 ![Captura de pantalla de Pixelfed](./doc/screenshots/screenshots.jpg)
 
+## Avisos / información importante
+
+## Some useful commands to know to manage your instance
+You need to run them from you pixelfed folder (usually `/var/www/pixelfed`). The `php.VERSION` might be changed according to you current package version.
+
+### Applying changes from the `.env` config file
+
+Once you made some changes, you need to run `php8.2 artisan config:cache && php8.2 artisan cache:clear` to apply them.
+Note: this will disconnect any logged-in account (including from the admin web UI).
+
+### Removing avatar cache to save space
+`php8.2 artisan avatar:storage-deep-clean`
+
+Use it to prune old avatars that are outdated or no longer used. This might save some disk space.
+
+### Fix missing avatars or refetch them.
+`php8.2 artisan  avatar:storage`
+
+It can be used to fetch remote avatars that are not loaded (or in case you deleted `/var/www/pixelfed/storage/app/public/cache/avatars` where they are stored).
+It might also be usefull to migrate that cache (only, not the other existing media) to an S3 storage, by refectching all of them.
+
+Be aware that this will generate a lot of "jobs" that will take time to be completed, and have a significant load on your server (especially bandwith and CPU).
+
+### When using S3
+
+- Delete non-used media that where not cleaned (it happens) : `php8.2 artisanmedia:gc` (Delete media uploads not attached to any active statuses)
+
+- Same but for media stored on S3 storage and still locally stored (doubles) : `php8.2 artisan media:s3gc` (Delete (local) media uploads that exist on S3)
+
+- Migrate your media to an S3 storage (you need to configure it first), so media uploaded before configuring S3 are migrated there: `php8.2 artisanmedia:migrate2cloud` (Move older media to cloud storage)
+
+- Migrate from one S3 backend the other one (change the configuration first): `php8.2 artisanmedia:cloud-url-rewrite` (Rewrite S3 media urls from local users)
+
 ## Documentación e recursos
 
 - Web oficial da app: <https://pixelfed.org/>

README_zh_Hans.md

@@ -25,12 +25,45 @@ In addition to taking over the functionality of Instagram, the functioning of Pi
 
 It is also possible to import your data from Instagram. 
 
-**分发版本：** 0.11.13~ynh1
+**分发版本：** 0.12.1~ynh1
 
 ## 截图
 
 ![Pixelfed 的截图](./doc/screenshots/screenshots.jpg)
 
+## 免责声明 / 重要信息
+
+## Some useful commands to know to manage your instance
+You need to run them from you pixelfed folder (usually `/var/www/pixelfed`). The `php.VERSION` might be changed according to you current package version.
+
+### Applying changes from the `.env` config file
+
+Once you made some changes, you need to run `php8.2 artisan config:cache && php8.2 artisan cache:clear` to apply them.
+Note: this will disconnect any logged-in account (including from the admin web UI).
+
+### Removing avatar cache to save space
+`php8.2 artisan avatar:storage-deep-clean`
+
+Use it to prune old avatars that are outdated or no longer used. This might save some disk space.
+
+### Fix missing avatars or refetch them.
+`php8.2 artisan  avatar:storage`
+
+It can be used to fetch remote avatars that are not loaded (or in case you deleted `/var/www/pixelfed/storage/app/public/cache/avatars` where they are stored).
+It might also be usefull to migrate that cache (only, not the other existing media) to an S3 storage, by refectching all of them.
+
+Be aware that this will generate a lot of "jobs" that will take time to be completed, and have a significant load on your server (especially bandwith and CPU).
+
+### When using S3
+
+- Delete non-used media that where not cleaned (it happens) : `php8.2 artisanmedia:gc` (Delete media uploads not attached to any active statuses)
+
+- Same but for media stored on S3 storage and still locally stored (doubles) : `php8.2 artisan media:s3gc` (Delete (local) media uploads that exist on S3)
+
+- Migrate your media to an S3 storage (you need to configure it first), so media uploaded before configuring S3 are migrated there: `php8.2 artisanmedia:migrate2cloud` (Move older media to cloud storage)
+
+- Migrate from one S3 backend the other one (change the configuration first): `php8.2 artisanmedia:cloud-url-rewrite` (Rewrite S3 media urls from local users)
+
 ## 文档与资源
 
 - 官方应用网站： <https://pixelfed.org/>