wiki/Catalogue-Self-Hosted/apps/app-pleroma.md

---
title: Pleroma
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, activitypub-fediverse, microblogging, elixir, fediverse, mrf, predecessor, akkoma]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=activitypub-fediverse, https://git.pleroma.social/pleroma/pleroma]
---

# 🐘 Pleroma

> **Le serveur microblogging Fediverse pionnier en Elixir** — léger, personnalisable et fondateur d'une famille de forks (Akkoma notamment), désormais en maintenance minimale.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [pleroma.social](https://pleroma.social/) |
| **GitLab** | [pleroma/pleroma](https://git.pleroma.social/pleroma/pleroma) |
| **Licence** | AGPL-3.0 (avec "CoC" et clauses éthiques) |
| **Langage** | Elixir, Phoenix |
| **Étoiles GitHub** | 10 ⭐ (sur le miroir GitHub) |
| **Dernière MAJ** | 2026-03 |
| **Catégorie** | [[cat-activitypub-fediverse\|ActivityPub / Fediverse]] |

## 📝 Description

**Pleroma** est l'un des **pionniers historiques du microblogging ActivityPub**, lancé en 2017 par Lain Soykaf (alias **lain**), rejoint rapidement par **silverpill** (qui écrira plus tard **Mitra**). Pleroma a popularisé plusieurs concepts clés du Fediverse : la **légèreté extrême** (1 Go de RAM suffit), la **personnalisation poussée** (thèmes multiples, frontend alternatif comme **MastodonFE**), et surtout le **Message Rewrite Facility (MRF)**, un système de réécriture de messages qui sert aujourd'hui de **modèle de modération décentralisée**.

À son apogée en 2019-2022, Pleroma était **le challenger principal de Mastodon** : API Mastodon-compatible, clients tiers, thème sombre, support natif de PleromaFE, AkkomaFE, etc. De nombreuses instances européennes (BDX.town en France, Lain.com en Allemagne) l'ont choisi pour sa sobriété technique et sa philosophie de modération active.

L'histoire a cependant marqué un **virage** : fin 2022, le mainteneur principal a annoncé **abandonner Pleroma** et **forker le projet sous le nom Akkoma** avec l'équipe BDX.town. L'instance Lain.com a aussi migré vers Mitra. Pleroma upstream est désormais en **maintenance minimale** — correctifs de sécurité publiés ponctuellement, mais plus de nouvelles fonctionnalités. De nombreuses instances ont **basculé sur Akkoma**, qui hérite de la stack technique et de l'API.

Cela dit, Pleroma reste **historiquement et techniquement incontournable** : si vous tombez sur une instance Pleroma encore active, elle parle toujours ActivityPub correctement avec Mastodon, et son **MRF** (avec filtres mots-clés, anti-spam, blocage d'instance) reste une référence pédagogique.

## 🚀 Installation

### Option recommandée : Docker (image communauté)

```yaml
# docker-compose.yml
services:
  db:
    image: postgres:14-alpine
    container_name: pleroma-db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=pleroma
      - POSTGRES_PASSWORD=***      - POSTGRES_DB=pleroma
    volumes:
      - ./pgdata:/var/lib/postgresql/data

  pleroma:
    image: zixia/pleroma:latest
    container_name: pleroma
    restart: unless-stopped
    environment:
      - DOMAIN=pleroma.example.org
      - INSTANCE_NAME=Mon Pleroma
      - ADMIN_EMAIL=admin@example.org
      - SECRET_KEY_BASE=change...et
    depends_on:
      - db
    ports:
      - "4000:4000"
    volumes:
      - ./uploads:/var/lib/pleroma/uploads
      - ./config:/etc/pleroma
```

### Option 2 : Installation OTP native (Debian/Ubuntu)

```bash
# Utiliser le paquet Debian de la communauté Akkoma (compatible Pleroma)
wget https://github.com/BDX-town/Akkoma/releases/latest/download/akkoma_***_all.deb
sudo apt install ./akkoma_***_all.deb
```

## ⚙️ Configuration Initiale

1. **Générer la config** : `pleroma_ctl instance gen --output /etc/pleroma/config.exs --output-psql /tmp/setup_db.psql`.
2. **Initialiser la base** : `sudo -u pleroma psql -f /tmp/setup_db.psql`.
3. **Migrer** : `sudo -u pleroma pleroma_ctl migrate`.
4. **Créer le compte admin** : `sudo -u pleroma pleroma_ctl user new admin vous admin@example.org --admin`.
5. **Démarrer** : `sudo systemctl start pleroma`.
6. **Activer HTTPS** : Caddy/Traefik/Nginx, obligatoire.

## 🔄 Alternatives

### Open Source
- [[app-akkoma]] — **Fork communautaire actif** de Pleroma, choix recommandé aujourd'hui.
- [[app-mastodon]] — Standard, en Ruby.
- [[app-mitra]] — Microblog Fediverse en Rust, par un co-auteur de Pleroma.
- [[app-misskey]] — Concurrent japonais, en Node + Vue.
- [[app-snac]] — Ultra-minimaliste en C.

### Propriétaires (ce que cette app remplace)
- **Twitter / X** — centralisé, traque publicitaire.
- **Threads** (Meta) — non fédéré.
- **Gab / Parler** — controversés, centralisés.
- **Substack Notes** — non fédéré.

## 🔐 Sécurité

- **Authentification** : locale (email + mot de passe) + 2FA TOTP, OAuth 2.0 standard.
- **MRF (Message Rewrite Facility)** : cœur de la sécurité Pleroma. Permet de **réécrire les messages à la volée** (anti-doxxing, anti-spam), **bloquer des instances**, **filtrer des mots-clés**. C'est l'invention Pleroma la plus reprise.
- **HTTPS** : obligatoire derrière un reverse proxy.
- **Fédération** : Pleroma a défini plusieurs extensions ActivityPub adoptées par Akkoma/Mitra. Compatible avec Mastodon.
- **Mises à jour** : **critique** car le projet est en maintenance minimale. **Migrer vers Akkoma** est la recommandation actuelle pour une instance Pleroma de production.
- **Sauvegardes** : `pg_dump` + volume `uploads/`. Pleroma fournit `pleroma_ctl backup` pour un export complet.

## 📚 Ressources

- [Site officiel Pleroma](https://pleroma.social/)
- [Dépôt GitLab Pleroma](https://git.pleroma.social/pleroma/pleroma)
- [Documentation Pleroma](https://docs.pleroma.social/)
- [MRF — Modération](https://docs.pleroma.social/backend/configuration/mrf/)

## Pages Liées
- [[cat-activitypub-fediverse]] — Catégorie parente
- [[app-akkoma]] — **Fork recommandé** pour les nouveaux déploiements
- [[app-mitra]] — Autre fork par silverpill, en Rust
- [[recettes-docker-compose]] — Templates Docker