mirror of
https://github.com/YunoHost-Apps/pixelfed_ynh.git
synced 2024-09-03 20:06:04 +02:00
88 lines
4.4 KiB
Markdown
88 lines
4.4 KiB
Markdown
<!--
|
|
Ohart ongi: README hau automatikoki sortu da <https://github.com/YunoHost/apps/tree/master/tools/readme_generator>ri esker
|
|
EZ editatu eskuz.
|
|
-->
|
|
|
|
# Pixelfed YunoHost-erako
|
|
|
|
[](https://dash.yunohost.org/appci/app/pixelfed)  
|
|
|
|
[](https://install-app.yunohost.org/?app=pixelfed)
|
|
|
|
*[Irakurri README hau beste hizkuntzatan.](./ALL_README.md)*
|
|
|
|
> *Pakete honek Pixelfed YunoHost zerbitzari batean azkar eta zailtasunik gabe instalatzea ahalbidetzen dizu.*
|
|
> *YunoHost ez baduzu, kontsultatu [gida](https://yunohost.org/install) nola instalatu ikasteko.*
|
|
|
|
## Aurreikuspena
|
|
|
|
PixelFed is a decentralized and federated image sharing software under development.
|
|
In addition to taking over the functionality of Instagram, the functioning of PixelFed is:
|
|
|
|
* Decentralized: Each instance can follow one or more other PixelFed instances in order to allow their respective members to interact. A first pixelfed.social public body limited to 10,000 members has already been created.
|
|
|
|
* Federated: Via the ActivityPub protocol, PixelFed can interact with other software that is part of the Fediverse, such as Mastodon or PeerTube for example.
|
|
|
|
It is also possible to import your data from Instagram.
|
|
|
|
**Paketatutako bertsioa:** 0.12.1~ynh1
|
|
|
|
## Pantaila-argazkiak
|
|
|
|
|
|
|
|
## 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/>
|
|
- Erabiltzaileen dokumentazio ofiziala: <https://docs.pixelfed.org/>
|
|
- Administratzaileen dokumentazio ofiziala: <https://docs.pixelfed.org/running-pixelfed/administration.html>
|
|
- Jatorrizko aplikazioaren kode-gordailua: <https://github.com/pixelfed/pixelfed>
|
|
- YunoHost Denda: <https://apps.yunohost.org/app/pixelfed>
|
|
- Eman errore baten berri: <https://github.com/YunoHost-Apps/pixelfed_ynh/issues>
|
|
|
|
## Garatzaileentzako informazioa
|
|
|
|
Bidali `pull request`a [`testing` abarrera](https://github.com/YunoHost-Apps/pixelfed_ynh/tree/testing).
|
|
|
|
`testing` abarra probatzeko, ondorengoa egin:
|
|
|
|
```bash
|
|
sudo yunohost app install https://github.com/YunoHost-Apps/pixelfed_ynh/tree/testing --debug
|
|
edo
|
|
sudo yunohost app upgrade pixelfed -u https://github.com/YunoHost-Apps/pixelfed_ynh/tree/testing --debug
|
|
```
|
|
|
|
**Informazio gehiago aplikazioaren paketatzeari buruz:** <https://yunohost.org/packaging_apps>
|