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

---
title: Akkoma
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, activitypub-fediverse, microblogging, pleroma-fork, fediverse, elixir, bdsm]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=activitypub-fediverse, https://github.com/BDX-town/Akkoma]
---

# 🎭 Akkoma

> **Le fork communautaire de Pleroma qui mise sur l'expression** — microblogging Fediverse en Elixir, plus rapide et personnalisable que Pleroma, avec un focus sur emoji, Markdown et theming.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [akkoma.social](https://akkoma.social/) |
| **GitHub** | [BDX-town/Akkoma](https://github.com/BDX-town/Akkoma) |
| **Licence** | AGPL-3.0 |
| **Langage** | Elixir, Phoenix |
| **Étoiles GitHub** | 117 ⭐ |
| **Dernière MAJ** | 2026-05 |
| **Catégorie** | [[cat-activitypub-fediverse\|ActivityPub / Fediverse]] |

## 📝 Description

**Akkoma** est un **fork de Pleroma** initié en 2022 par l'instance française **BDX.town** (Bordeaux), et rejoint rapidement par d'autres instances qui cherchaient à **redonner le contrôle à la communauté** face à la stagnation du dépôt principal Pleroma. L'objectif affiché : **reprendre les bonnes idées de Pleroma et y ajouter des fonctionnalités d'expression** qui étaient attendues depuis longtemps.

Les ajouts emblématiques d'Akkoma par rapport à Pleroma upstream :
- **Markdown étendu** dans les posts, avec support natif des animations (texte qui défile, messages "Mastodon-style").
- **Réactions emoji multiples** : vous pouvez réagir avec N emojis différents à un même post (Mastodon ne le permet pas nativement).
- **Quote posts** intégrés (la fonctionnalité que Mastodon a mis des années à stabiliser).
- **Antenna posts** : réémission automatique vers des "antennes" thématiques (équivalent listes publiques intelligentes).
- **Emoji reactions on profiles** et **rich user metadata**.
- **API Mastodon compatible** + extensions ActivityPub propres (interopérables avec Pleroma/Mastodon).

Côté technique, Akkoma conserve la stack Pleroma : **Elixir/Phoenix**, **PostgreSQL**, **uploads locaux ou S3**. Le projet fournit des **paquets Docker officiels**, des **paquets OTP** et des **paquets Debian**. La consommation mémoire est plus légère que Mastodon (souvent 500 Mo - 1 Go pour une instance publique), ce qui en fait un choix prisé des self-hosters avec un petit VPS.

Forces : fork vivant et dynamique, contributions régulières, parfait compromis Mastodon/Pleroma, theming riche. Faiblesses : documentation parfois en retard sur les features, projet dépendant de la santé de l'équipe Pleroma upstream, plus petit réseau d'instances que Mastodon.

## 🚀 Installation

### Option recommandée : Docker

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

  akkoma:
    image: akkoma/akkoma:latest
    container_name: akkoma
    restart: unless-stopped
    environment:
      - AKKOMA_INSTANCE_URL=https://akkoma.example.org
      - AKKOMA_INSTANCE_NAME=Mon Akkoma
    depends_on:
      - akkoma-db
    volumes:
      - ./uploads:/var/lib/akkoma/uploads
      - ./config:/etc/akkoma
    ports:
      - "4000:4000"
```

### Option 2 : Paquet OTP natif

```bash
wget https://akkoma-updates.s3-website.fr-par.scw.cloud/develop/debian/pool/main/a/akkoma/akkoma_***_all.deb
sudo apt install ./akkoma_***_all.deb
sudo systemctl start akkoma
```

## ⚙️ Configuration Initiale

1. **Premier démarrage** : `docker compose up -d` puis exécuter `docker compose exec akkoma akkoma_ctl config gen` pour générer la config.
2. **Éditer `config/prod.exs`** : hostname, paramètres SMTP, liste d'instances à bloquer.
3. **Créer le compte admin** : `docker compose exec akkoma akkoma_ctl user new admin vous admin@example.org --admin`.
4. **Activer la modération** : configurer la file de signalements et la politique de mots interdits.
5. **Personnaliser** : activer les thèmes (Buster, Rounded, Mellifluous, Whatever), configurer les custom emojis.
6. **Sauvegardes** : `pg_dump` quotidien + volume `uploads/`.

## 🔄 Alternatives

### Open Source
- [[app-pleroma]] — Le projet d'origine, désormais en maintenance minimale.
- [[app-mastodon]] — Le standard, en Ruby.
- [[app-misskey]] — Microblogging japonais très riche en features (équivalent Akkoma côté Misskey).
- [[app-sharkey]] — Fork de Misskey, plus communautaire.
- [[app-ktistec]] — Plus minimaliste, en Crystal.

### Propriétaires (ce que cette app remplace)
- **Twitter / X** — centralisé, traque publicitaire.
- **Threads** (Meta) — non fédéré, lié à Instagram.
- **Discord** (pour les micro-communautés) — non fédéré, pas d'algorithme public.
- **Hive Social** — post-mortem, modèle centralisé.

## 🔐 Sécurité

- **Authentification** : locale + OAuth 2.0 (compatible clients Mastodon). 2FA TOTP supportée.
- **HTTPS** : obligatoire, recommandé via Caddy ou Traefik.
- **Fédération** : parle ActivityPub 1.0 / 2.0 et **un sous-ensemble des extensions Pleroma**. Interopérable avec Mastodon mais certaines features (quote posts) ne sont rendues que par les instances qui les comprennent.
- **Modération** : **MRF (Message Rewrite Facility)** puissant, permet de réécrire, bloquer ou sanitiser les messages en fonction d'instances ou de mots-clés. Outil mature issu de Pleroma.
- **Rate limiting** : par IP et par utilisateur, configurable.
- **Uploads** : par défaut locaux, support natif S3/MinIO pour la prod.
- **Sauvegardes** : la commande `akkoma_ctl backup` permet un export cohérent (DB + uploads + config).

## 📚 Ressources

- [Site officiel Akkoma](https://akkoma.social/)
- [GitHub BDX-town/Akkoma](https://github.com/BDX-town/Akkoma)
- [Documentation Akkoma](https://docs.akkoma.dev/)
- [Runtipi-appstore discussion](https://github.com/runtipi/runtipi-appstore/discussions/6521)

## Pages Liées
- [[cat-activitypub-fediverse]] — Catégorie parente
- [[app-pleroma]] — Projet d'origine
- [[app-mastodon]] — Standard du microblogging Fediverse
- [[recettes-docker-compose]] — Templates Docker