111 lines
5.7 KiB
Markdown
111 lines
5.7 KiB
Markdown
---
|
|
title: Ktistec
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, activitypub-fediverse, microblogging, crystal, single-user, fediverse, lightweight]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=activitypub-fediverse, https://github.com/toddsundsted/ktistec]
|
|
---
|
|
|
|
# 💎 Ktistec
|
|
|
|
> **Le serveur ActivityPub minimaliste en Crystal** — auto-hébergez votre propre nœud Fediverse dans un binaire léger, sans Rails ni JavaScript à exécuter côté client.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [ktistec.com](https://ktistec.com/) |
|
|
| **GitHub** | [toddsundsted/ktistec](https://github.com/toddsundsted/ktistec) |
|
|
| **Licence** | AGPL-3.0 |
|
|
| **Langage** | Crystal |
|
|
| **Étoiles GitHub** | 23 ⭐ |
|
|
| **Dernière MAJ** | 2026-05 |
|
|
| **Catégorie** | [[cat-activitypub-fediverse\|ActivityPub / Fediverse]] |
|
|
|
|
## 📝 Description
|
|
|
|
**Ktistec** est un **serveur microblogging ActivityPub écrit en Crystal** par Todd Sundsted. Crystal est un langage compilé, statiquement typé, avec une syntaxe proche de Ruby mais des performances proches de C — ce qui donne à Ktistec un profil **léger, rapide et monobinaire**. Le projet se positionne explicitement comme une alternative minimale à Mastodon, Pleroma et autres, avec un code source compact et lisible.
|
|
|
|
L'ambition est de fournir **un serveur Fediverse personnel complet** : messages, boosts, favoris, follows, listes, notifications, recherche fédérée, threads. Ktistec est mono-utilisateur par défaut (l'auteur décrit l'usage comme un **nœud personnel**, pas un réseau), mais peut techniquement servir plusieurs comptes. L'**API ActivityPub** est complète et le projet **fédère avec Mastodon, Pleroma, Misskey, Akkoma, Pixelfed et la plupart des implémentations matures**.
|
|
|
|
Le code met l'accent sur la **concision** : un seul dépôt, pas de surcouche framework lourde, base SQLite par défaut, **binaire statique** facile à déployer. Les **rôles** supportent une certaine modularité : vous pouvez choisir d'exposer votre Ktistec en lecture seule, en local seulement, ou en serveur public classique. L'interface web est intentionnellement sobre — pas de SPA JavaScript, les pages se génèrent côté serveur.
|
|
|
|
Forces : **consommation mémoire très faible** (souvent < 50 Mo de RSS), binaire unique, code lisible, parfait pour un VPS modeste, image Docker officielle. Faiblesses : documentation moins fournie que Pleroma/Mastodon, instance mono-utilisateur assumée, pas de stockage média avancé, communauté restreinte (1 développeur principal).
|
|
|
|
## 🚀 Installation
|
|
|
|
### Option recommandée : Docker
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
ktistec:
|
|
image: ghcr.io/toddsundsted/ktistec:latest
|
|
container_name: ktistec
|
|
restart: unless-stopped
|
|
environment:
|
|
- KEMAL_ENV=production
|
|
- KTISTEC_HOST=ktistec.example.org
|
|
- KTISTEC_PORT=3000
|
|
- DATABASE_URL=sqlite3:///data/ktistec.db
|
|
volumes:
|
|
- ./data:/data
|
|
ports:
|
|
- "3000:3000"
|
|
```
|
|
|
|
### Option 2 : Binaire natif Crystal
|
|
|
|
```bash
|
|
git clone https://github.com/toddsundsted/ktistec.git
|
|
cd ktistec
|
|
shards install
|
|
crystal build src/ktistec.cr --release
|
|
KTISTEC_HOST=localhost ./ktistec
|
|
```
|
|
|
|
## ⚙️ Configuration Initiale
|
|
|
|
1. **Définir le domaine** : Ktistec utilise `KTISTEC_HOST` pour générer l'URL de l'acteur ActivityPub.
|
|
2. **Créer le premier compte** : ouvrir l'interface web, s'inscrire (le premier compte devient admin).
|
|
3. **Configurer le profil public** : avatar, bio, lien d'en-tête. Les followers fédérés verront ces métadonnées.
|
|
4. **Tester la fédération** : depuis un compte Mastodon distant, faire `@vous@ktistec.example.org` pour vérifier Webfinger.
|
|
5. **Sauvegardes** : un simple `cp` du fichier `ktistec.db` suffit, plus le volume des médias uploadés.
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
- [[app-pleroma]] — Plus mature, plus d'instances, en Elixir.
|
|
- [[app-mastodon]] — Le standard, en Ruby on Rails.
|
|
- [[app-akkoma]] — Fork léger de Pleroma.
|
|
- [[app-mitra]] — Microblogging Fediverse en Rust (même philosophie minimaliste).
|
|
- [[app-snac]] — Encore plus minimaliste, écrit en C.
|
|
|
|
### Propriétaires (ce que cette app remplace)
|
|
- **Twitter / X** — centralisé, traque publicitaire.
|
|
- **Threads** (Meta) — non fédéré, lié à Instagram.
|
|
- **Bluesky** (semi-décentralisé) — modèle AT Protocol différent.
|
|
|
|
## 🔐 Sécurité
|
|
|
|
- **Authentification** : Ktistec gère nativement les comptes locaux avec mots de passe hashés (bcrypt). Le **premier compte créé est administrateur** — ne pas laisser l'inscription ouverte ou la verrouiller après création.
|
|
- **HTTPS obligatoire** : la fédération ActivityPub exige TLS. Let's Encrypt via Caddy/Nginx.
|
|
- **Webfinger** : Ktistec expose `/.well-known/webfinger`, `/.well-known/nodeinfo`, `/actor` et les endpoints standards.
|
|
- **Limites d'API** : Ktistec implémente un rate-limiting basique. Pour un usage public, il est recommandé d'ajouter un reverse proxy durci (CrowdSec, fail2ban).
|
|
- **Sauvegarde** : le projet étant mono-utilisateur, **sauvegardez régulièrement le fichier SQLite** (c'est toute votre base de données).
|
|
|
|
## 📚 Ressources
|
|
|
|
- [GitHub toddsundsted/ktistec](https://github.com/toddsundsted/ktistec)
|
|
- [Reddit r/crystal_programming — Présentation](https://www.reddit.com/r/crystal_programming/comments/108hxu6/ktistec_a_lightweight_activitypub_server_in/)
|
|
- [Crystal Forum — Discussion Ktistec](https://forum.crystal-lang.org/t/ktistec-an-activitypub-server/3010)
|
|
|
|
## Pages Liées
|
|
- [[cat-activitypub-fediverse]] — Catégorie parente
|
|
- [[app-mitra]] — Approche minimaliste similaire en Rust
|
|
- [[app-snac]] — Encore plus minimaliste, en C
|
|
- [[recettes-docker-compose]] — Templates Docker
|