From a8265394bf81f41cff20b6cc6a02c49d180c219a Mon Sep 17 00:00:00 2001 From: anmol26s <5068843+anmol26s@users.noreply.github.com> Date: Mon, 5 Nov 2018 20:49:12 +0530 Subject: [PATCH 1/3] Updated readme --- README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 66 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index f0f4ce1..df40562 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,66 @@ -# pleroma_ynh -Pleroma is an OStatus-compatible social networking server written in Elixir, compatible with GNU Social and Mastodon +# Pleroma app for Yunohost + +[![Integration level](https://dash.yunohost.org/integration/pleroma.svg)](https://ci-apps.yunohost.org/jenkins/job/pleroma%20%28Community%29/lastBuild/consoleFull) + +[![Install pleroma with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=pleroma) + +**Links:** +[Yunohost](https://yunohost.org) +[Pleroma](https://git.pleroma.social/pleroma/pleroma) + +## Pleroma + +[Pleroma](https://git.pleroma.social/pleroma/pleroma) is an **OStatus-compatible social networking server** written in Elixir, compatible with **GNU Social** **Mastodon**. It is high-performance and can run on small devices like a **Raspberry Pi**. + +For clients it supports both the **GNU Social API** with **Qvitter extensions** and the **Mastodon client API**. + +**Mastodon web front-end for Pleroma:** Add **/web** in front of your Pleroma domain, eg. pleroma.domain.tld/web + +## Mobile clients that work with Pleroma: + +- Twidere +- Tusky +- Pawoo (Android + iOS) +- Subway Tooter +- Amaroq (iOS) +- Tootdon (Android + iOS) +- Tootle (iOS) + +## Important points to read before installing + +1. **Pleroma** require a dedicated **root domain**, eg. pleroma.domain.tld +1. **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**. +1. This package is **multi-instance** that means you can run **multiple Pleroma instances** on a **single server**. +1. There is **No LDAP** support for Pleroma yet. + +## Admin Tasks +Go to **cd /var/www/pleroma/pleroma**. + +### Register a User + +**Run:** + + $ sudo -u pleroma MIX_ENV=prod mix register_user + +The **name** appears on **statuses**, while the **nickname** corresponds to the **user**, e.g. @nickname@instance.tld + + +### Password reset + +**Run:** + + $ MIX_ENV=prod mix generate_password_reset 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**. + +**Run:** + + $ MIX_ENV=prodmix set_moderator username [true|false] + +**True** option will **make the user moderator** and **flase** will **take away the moderator privileges** from the user. + From f24103b822acd6fc340cd6bc3c1ca2c160fa062d Mon Sep 17 00:00:00 2001 From: anmol26s <5068843+anmol26s@users.noreply.github.com> Date: Mon, 5 Nov 2018 20:51:56 +0530 Subject: [PATCH 2/3] Updated readme --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index df40562..200ee2c 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,8 @@ [![Install pleroma with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=pleroma) -**Links:** -[Yunohost](https://yunohost.org) +**Links:**
+[Yunohost](https://yunohost.org)
[Pleroma](https://git.pleroma.social/pleroma/pleroma) ## Pleroma From 1e82a70bd919d94173f260ecd421a5810b4b2bf4 Mon Sep 17 00:00:00 2001 From: anmol26s <5068843+anmol26s@users.noreply.github.com> Date: Mon, 5 Nov 2018 21:31:14 +0530 Subject: [PATCH 3/3] Updated readme --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 200ee2c..cc62f94 100644 --- a/README.md +++ b/README.md @@ -6,13 +6,16 @@ **Links:**
[Yunohost](https://yunohost.org)
-[Pleroma](https://git.pleroma.social/pleroma/pleroma) +[Pleroma](https://pleroma.social/)
+[Pleroma Gitlab repo](https://git.pleroma.social/pleroma/pleroma) ## Pleroma -[Pleroma](https://git.pleroma.social/pleroma/pleroma) is an **OStatus-compatible social networking server** written in Elixir, compatible with **GNU Social** **Mastodon**. It is high-performance and can run on small devices like a **Raspberry Pi**. +[Pleroma](https://pleroma.social/) is an **OStatus and ActivityPub compatible social networking server** written in Elixir, compatible with **GNU Social** and **Mastodon**. It is high-performance and can run on small devices like a **Raspberry Pi**. -For clients it supports both the **GNU Social API** with **Qvitter extensions** and the **Mastodon client API**. +For clients it supports both the **GNU Social API** with **Qvitter extensions** and the **Mastodon client API**.
+ +For user friendly details about Pleroma: [see here](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