1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/pleroma_ynh.git synced 2024-09-03 20:15:59 +02:00

Merge pull request #244 from YunoHost-Apps/testing

Remove migrate_to_db at upgrade
This commit is contained in:
yalh76 2023-05-02 01:00:09 +02:00 committed by GitHub
commit b4fc79095c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
9 changed files with 133 additions and 61 deletions

View file

@ -23,9 +23,7 @@ For user friendly details about Pleroma: [see here](https://blog.soykaf.com/post
**Mastodon web front-end for Pleroma:** Add **/web** in front of your Pleroma domain, eg. pleroma.domain.tld/web
**Shipped version:** 2.5.1~ynh1
**Demo:** http://distsn.org/pleroma-instances.html
**Shipped version:** 2.5.1~ynh2
## Screenshots
@ -42,31 +40,35 @@ For user friendly details about Pleroma: [see here](https://blog.soykaf.com/post
- LDAP supported but HTTP auth not.
## Admin Tasks
Go to **cd /var/www/pleroma/live**.
Connect with SSH to your Yunohost server as YNH admin user.
For the commands syntax, have in mind the specificities of [Yunohost Pleroma install](./doc/yunohost.md).
### Adding users
**Run:**
$ ( cd /var/www/pleroma/live && sudo -u pleroma MIX_ENV=prod ./bin/pleroma_ctl user new <NICKNAME> <EMAIL> )
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user new <userName> <userEmail>"
```
### Password reset
**Run:**
$ ( cd /var/www/pleroma/live && sudo -u pleroma MIX_ENV=prod ./bin/pleroma_ctl user reset_password <NICKNAME> )
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user reset_password <userName>"
```
This will generate a **password reset link** that you can then send to the user.
### Moderators
You can make users **moderators**. They will then be able to **delete any post**.
You can make users **moderators**. They will then be able to _delete any post_.
**Run:**
$ ( cd /var/www/pleroma/live && sudo -u pleroma MIX_ENV=prod ./bin/pleroma_ctl user set <NICKNAME> --[no-]admin )
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user set <userName> --admin"
```
**--admin** option will **make the user moderator** and **--no-admin** will **take away the moderator privileges** from the user.
Note: `--admin` option will _make the user moderator_ and `--no-admin` will _take away_ the moderator privileges from the user.
## Documentation and resources

View file

@ -16,16 +16,14 @@ Si vous navez pas YunoHost, regardez [ici](https://yunohost.org/#/install) po
## Vue densemble
Pleroma is a microblogging server software that can federate (= exchange messages with) other servers that support ActivityPub. What that means is that you can host a server for yourself or your friends and stay in control of your online identity, but still exchange messages with people on larger servers. Pleroma will federate with all servers that implement ActivityPub, like Friendica, GNU Social, Hubzilla, Mastodon, Misskey, Peertube, and Pixelfed.
Pleroma est un logiciel serveur de microblog qui peut fédérer (cest à dire échanger des messages) avec dautres serveurs qui supportent le protocole ActivityPub. Cela signifie que vous pouvez héberger un serveur pour vous ou vos amis et garder le contrôle de votre identité en ligne, tout en communiquant avec des personnes hébergées sur des serveurs différents et plus importants tel que Friendica, GNU Social, Hubzilla, Mastodon, Misskey, Peertube, ou Pixelfed.
For user friendly details about Pleroma: [see here](https://blog.soykaf.com/post/what-is-pleroma/)
Pour des informations plus détaillées sur Pleroma voir [What is Pleroma](https://blog.soykaf.com/post/what-is-pleroma/)
**Mastodon web front-end for Pleroma:** Add **/web** in front of your Pleroma domain, eg. pleroma.domain.tld/web
**Interface utilisateur Mastodon pour Pleroma :** Ajouter `/web` à la fin du nom de domaine (URL) de votre installation, par exemple : `https://pleroma.domain.tld/web`
**Version incluse :** 2.5.1~ynh1
**Démo :** http://distsn.org/pleroma-instances.html
**Version incluse :** 2.5.1~ynh2
## Captures décran
@ -35,38 +33,41 @@ For user friendly details about Pleroma: [see here](https://blog.soykaf.com/post
## Limitations
- **Pleroma** require a dedicated **root domain**, eg. pleroma.domain.tld
- **Pleroma** require a valid **certificate** installed on the domain. Yunohost can **install Letsencrypt certificate** on the domain from **admin web-interface** or through **command-line**.
- This package is currently set to **single-instance** that means you can run a **single Pleroma instance** on a **single server**.
- The admin **password** entered when installing must **not** contain **special characters**. (See [issue #132](https://github.com/YunoHost-Apps/pleroma_ynh/issues/132))
- LDAP supported but HTTP auth not.
- Pleroma doit impérativement sinstaller sur son propre **nom de domaine dédié** (ou sous-domaine), par ex. pleroma.domain.tld
- Pleroma nécessite par ailleurs un **certificat SSL** valide activé sur ce domaine. Yunohost peut installer et configurer un **certificat Letsencrypt** pour le domaine depuis linterface d'administration de Yunohost ou avec la ligne de commande.
- Ce paquet est actuellement configuré pour une **instance unique**, cest-à-dire que lon ne peut installer _quune seule instance_ de Pleroma sur un même serveur Yunohost.
- Le **mot de passe** saisi durant linstallation ne doit _en aucun cas_ contenir de **caractères spéciaux**. (Voir [issue #132](https://github.com/YunoHost-Apps/pleroma_ynh/issues/132))
- Lauthentification LDAP fonctionne, mais pas `HTTP auth` en revanche.
## Admin Tasks
Go to **cd /var/www/pleroma/live**.
## Tâches dadministration
### Adding users
Se connecter avec SSH à votre serveur Yunohost avec le compte admin (nous parlons ici de ladmin YNH pas de ladmin de Pleroma).
Pour la syntaxe des commandes, garder en tête les spécificités dune installations de [Pleroma avec Yunohost](./doc/yunohost_fr.md).
**Run:**
$ ( cd /var/www/pleroma/live && sudo -u pleroma MIX_ENV=prod ./bin/pleroma_ctl user new <NICKNAME> <EMAIL> )
### Ajouter un utilisateur ou utilisatrice
### Password reset
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user new <userName> <userEmail>"
```
**Run:**
### Changer de mot de passe
$ ( cd /var/www/pleroma/live && sudo -u pleroma MIX_ENV=prod ./bin/pleroma_ctl user reset_password <NICKNAME> )
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user reset_password <userName>"
```
This will generate a **password reset link** that you can then send to the user.
Ceci générera un **lien de réinitialisation** (URL) du mot de passe, que vous pouvez envoyer à lutilisateur ou utilisatrice.
### Moderators
### Modérateurs
You can make users **moderators**. They will then be able to **delete any post**.
Vous pouvez donner à des utilisateurs ou utilisatrices les droits de **modération**. Ils ou elles pourront alors _supprimer_ nimporte quel billet publié par nimporte quel autre compte.
**Run:**
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user set <userName> --admin"
```
$ ( cd /var/www/pleroma/live && sudo -u pleroma MIX_ENV=prod ./bin/pleroma_ctl user set <NICKNAME> --[no-]admin )
**--admin** option will **make the user moderator** and **--no-admin** will **take away the moderator privileges** from the user.
Note : loption `--admin` donne au compte _les droits de moderation_ et avec loption `--no-admin` à linverse on _enlève_ les privilèges de modération de celui-ci.
## Documentations et ressources

5
doc/DESCRIPTION_fr.md Normal file
View file

@ -0,0 +1,5 @@
Pleroma est un logiciel serveur de microblog qui peut fédérer (cest à dire échanger des messages) avec dautres serveurs qui supportent le protocole ActivityPub. Cela signifie que vous pouvez héberger un serveur pour vous ou vos amis et garder le contrôle de votre identité en ligne, tout en communiquant avec des personnes hébergées sur des serveurs différents et plus importants tel que Friendica, GNU Social, Hubzilla, Mastodon, Misskey, Peertube, ou Pixelfed.
Pour des informations plus détaillées sur Pleroma voir [What is Pleroma](https://blog.soykaf.com/post/what-is-pleroma/)
**Interface utilisateur Mastodon pour Pleroma :** Ajouter `/web` à la fin du nom de domaine (URL) de votre installation, par exemple : `https://pleroma.domain.tld/web`

View file

@ -7,28 +7,32 @@
- LDAP supported but HTTP auth not.
## Admin Tasks
Go to **cd /var/www/pleroma/live**.
Connect with SSH to your Yunohost server as YNH admin user.
For the commands syntax, have in mind the specificities of [Yunohost Pleroma install](./doc/yunohost.md).
### Adding users
**Run:**
$ ( cd /var/www/pleroma/live && sudo -u pleroma MIX_ENV=prod ./bin/pleroma_ctl user new <NICKNAME> <EMAIL> )
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user new <userName> <userEmail>"
```
### Password reset
**Run:**
$ ( cd /var/www/pleroma/live && sudo -u pleroma MIX_ENV=prod ./bin/pleroma_ctl user reset_password <NICKNAME> )
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user reset_password <userName>"
```
This will generate a **password reset link** that you can then send to the user.
### Moderators
You can make users **moderators**. They will then be able to **delete any post**.
You can make users **moderators**. They will then be able to _delete any post_.
**Run:**
$ ( cd /var/www/pleroma/live && sudo -u pleroma MIX_ENV=prod ./bin/pleroma_ctl user set <NICKNAME> --[no-]admin )
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user set <userName> --admin"
```
**--admin** option will **make the user moderator** and **--no-admin** will **take away the moderator privileges** from the user.
Note: `--admin` option will _make the user moderator_ and `--no-admin` will _take away_ the moderator privileges from the user.

37
doc/DISCLAIMER_fr.md Normal file
View file

@ -0,0 +1,37 @@
## Limitations
- Pleroma doit impérativement sinstaller sur son propre **nom de domaine dédié** (ou sous-domaine), par ex. pleroma.domain.tld
- Pleroma nécessite par ailleurs un **certificat SSL** valide activé sur ce domaine. Yunohost peut installer et configurer un **certificat Letsencrypt** pour le domaine depuis linterface d'administration de Yunohost ou avec la ligne de commande.
- Ce paquet est actuellement configuré pour une **instance unique**, cest-à-dire que lon ne peut installer _quune seule instance_ de Pleroma sur un même serveur Yunohost.
- Le **mot de passe** saisi durant linstallation ne doit _en aucun cas_ contenir de **caractères spéciaux**. (Voir [issue #132](https://github.com/YunoHost-Apps/pleroma_ynh/issues/132))
- Lauthentification LDAP fonctionne, mais pas `HTTP auth` en revanche.
## Tâches dadministration
Se connecter avec SSH à votre serveur Yunohost avec le compte admin (nous parlons ici de ladmin YNH pas de ladmin de Pleroma).
Pour la syntaxe des commandes, garder en tête les spécificités dune installations de [Pleroma avec Yunohost](./doc/yunohost_fr.md).
### Ajouter un utilisateur ou utilisatrice
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user new <userName> <userEmail>"
```
### Changer de mot de passe
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user reset_password <userName>"
```
Ceci générera un **lien de réinitialisation** (URL) du mot de passe, que vous pouvez envoyer à lutilisateur ou utilisatrice.
### Modérateurs
Vous pouvez donner à des utilisateurs ou utilisatrices les droits de **modération**. Ils ou elles pourront alors _supprimer_ nimporte quel billet publié par nimporte quel autre compte.
```
sudo su pleroma -s $SHELL -lc "/var/www/pleroma/live/bin/pleroma_ctl user set <userName> --admin"
```
Note : loption `--admin` donne au compte _les droits de moderation_ et avec loption `--no-admin` à linverse on _enlève_ les privilèges de modération de celui-ci.

16
doc/yunohost.md Normal file
View file

@ -0,0 +1,16 @@
# Pleroma and Yunohost
Some information, for all intents and purposes, on the differences between a direct installation of Pleroma (from the _releases_) and installation with the Yunohost application package.
| | Official Package | With Yunohost |
| --------------------------- | -------------------------- | --------------------------------------- |
| Install directory | `/opt/pleroma` | `/var/www/pleroma/live/` |
| Static directory | `/var/lib/pleroma/static` | `/etc/pleroma/config.exs` |
| Configuration file | `/etc/pleroma/config.exs` | `/etc/pleroma/config.exs` |
| Command line path | `/bin/pleroma_ctl` | `/var/www/pleroma/live/bin/pleroma_ctl` |
## Things to remember
- The installation of Pleroma with Yunohost is a so-called OTP installation (and not MIX, i.e. from the sources). Have this in mind, as the administration _commands_ are not the same in either case.
- All commands must be run as the `pleroma` user, who is _not_ part of Yunohost `admin` group, its not possible to invoque these commands directly with `sudo`.

16
doc/yunohost_fr.md Normal file
View file

@ -0,0 +1,16 @@
# Pleroma et Yunohost
Quelques informations, à toutes fins utiles, sur les différences entre une installation directe de Pleroma (depuis les _releases_ du dépôt officiel) et linstallation avec le package dapplication de Yunohost.
| | Package officiel | Avec Yunohost |
| --------------------------- | -------------------------- | --------------------------------------- |
| Répertoire dinstallation | `/opt/pleroma` | `/var/www/pleroma/live/` |
| Répertoire statique | `/var/lib/pleroma/static` | `/etc/pleroma/config.exs` |
| Fichier de configuration | `/etc/pleroma/config.exs` | `/etc/pleroma/config.exs` |
| Ligne de commandes | `/bin/pleroma_ctl` | `/var/www/pleroma/live/bin/pleroma_ctl` |
## A noter
- Linstallation de Pleroma avec Yunohost est une installation dite OTP (et non MIX, cest à dire à partir des sources). Information à mémoriser, dans la mesure où les commandes dadministration ne sont pas les mêmes dans lun ou lautre cas.
- Toutes les commandes doivent être exécutées en tant quutilisateur `pleroma`, qui nest _pas_ membre du groupe `admin` de Yunohost, celle-ci ne peuvent donc être invoquées directement avec `sudo`.

View file

@ -6,12 +6,11 @@
"en": "Federated social networking server built on open protocols",
"fr": "Serveur de réseautage social fédéré basé sur des protocoles ouverts"
},
"version": "2.5.1~ynh1",
"version": "2.5.1~ynh2",
"url": "https://pleroma.social/",
"upstream": {
"license": "AGPL-3.0-only",
"website": "https://pleroma.social/",
"demo": "http://distsn.org/pleroma-instances.html",
"admindoc": "https://docs.pleroma.social/",
"code": "https://git.pleroma.social/pleroma/pleroma/"
},

View file

@ -289,14 +289,6 @@ ynh_script_progression --message="Reloading NGINX web server..." --weight=1
ynh_systemd_action --service_name=nginx --action=reload
#=================================================
# POST INSTALL
#=================================================
# Correct path to 'static dir' in DB
# This must be done when Pleroma is running (i.e. after install/upgrade and start)
ynh_exec_warn_less ynh_exec_as $app -s $SHELL -lc "$final_path/live/bin/pleroma_ctl config migrate_to_db"
#=================================================
# END OF SCRIPT
#=================================================