Files
wiki/Catalogue-Self-Hosted/apps/app-wekan.md
T
2026-06-09 18:40:21 +02:00

134 lines
5.0 KiB
Markdown

---
title: WeKan
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, kanban, trello-alternative, nodejs, meteor, mongodb, docker, mit]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Kanban, https://github.com/wekan/wekan, https://github.com/wekan/wekan/wiki/Docker]
---
# 🗂️ WeKan
> **Le Kanban open source le plus déployé** — cloné depuis Trello, multi-tableaux, multi-utilisateurs, écrit en Meteor/Node.js et MongoDB.
## 📋 Informations Générales
| Champ | Valeur |
| :--- | :--- |
| **Site web** | [wekan.github.io](https://wekan.github.io/) |
| **GitHub** | [wekan/wekan](https://github.com/wekan/wekan) |
| **Licence** | MIT |
| **Langage** | JavaScript (Meteor / Node.js) |
| **Étoiles GitHub** | 2 978 ⭐ |
| **Dernière MAJ** | 2026-06-04 |
| **Catégorie** | [[cat-kanban\|Kanban]] |
## 📝 Description
**WeKan** (à l'origine "Restya", renommée par la suite) est l'un des **projets Kanban open source les plus anciens et matures**. Conçu dès 2014 comme un clone libre de Trello, il propose les classiques : tableaux, listes, cartes, étiquettes, membres, dates d'échéance, checklists, pièces jointes et activité. Il est écrit en **JavaScript avec le framework Meteor**, qui combine Node.js et MongoDB.
WeKan supporte l'**authentification multi-protocoles** (LDAP, Active Directory, OAuth2 via Google/GitHub/Keycloak, SAML via plugin), un **sandstorm.io** (bac à sable), et un **store de plugins** communautaire. Il existe des **clients desktop et mobiles** officiels (Linux, Windows, macOS, iOS, Android) et des intégrations comme **Wekan Desktop** ou **Nextcloud Talk** pour les notifications.
C'est le choix par défaut pour qui veut un **Trello-like auto-hébergé** avec une grosse communauté francophone, des snapshots Docker officiels, et la possibilité de fonctionner en mode **multi-utilisateurs via LDAP**. Voir aussi le fork [[app-4ga-boards]] qui ajoute des correctifs et simplifie l'install.
## 🚀 Installation
### Option recommandée : Docker Compose
```yaml
services:
wekan:
image: ghcr.io/wekan/wekan:v7.40
container_name: wekan
restart: unless-stopped
ports:
- "8080:8080"
environment:
WRITABLE_PATH: "/data"
MONGO_URL: "mongodb://mongo:27017/wekan"
ROOT_URL: "https://kanban.example.com"
MAIL_URL: "smtp://user:pass@smtp.example.com:25/"
MAIL_FROM: "WeKan <noreply@example.com>"
WITH_API: "true"
RICHER_CARD_COMMENT_EDITOR: "true"
depends_on:
- mongo
mongo:
image: mongo:6
container_name: wekan-mongo
restart: unless-stopped
command: ["--bind_ip_all"]
volumes:
- wekan-db:/data/db
healthcheck:
test: ["CMD", "mongosh", "--quiet", "--eval", "db.adminCommand('ping').ok"]
interval: 30s
timeout: 10s
retries: 5
volumes:
wekan-db:
```
### Snap (Linux)
```bash
sudo snap install wekan
sudo snap set wekan root-url="https://kanban.example.com"
sudo snap set wekan port='80'
```
## ⚙️ Configuration Initiale
1. Créer le premier compte (qui devient automatiquement administrateur).
2. Configurer le **reverse proxy HTTPS** (WeKan ne fait pas le TLS lui-même).
3. Activer le **LDAP** dans *Admin Panel → Authentication* pour synchroniser les utilisateurs.
4. Régler `ROOT_URL` pour que les liens et notifications e-mail fonctionnent.
5. Brancher **SMTP** (`MAIL_URL`) pour les invitations et notifications.
6. Sauvegarder régulièrement le volume `wekan-db` (dump MongoDB).
7. Envisager [[app-4ga-boards]] comme fork si l'upstream vous bloque sur un bug.
## 🔄 Alternatives
### Open Source
- [[app-planka]] — Kanban moderne (React/Redux), plus joli
- [[app-kanboard]] — Kanban PHP minimaliste
- [[app-vikunja]] — Tasks + Kanban en Go
- [[app-4ga-boards]] — Fork activement maintenu de WeKan
- [[app-openproject]] — Gestion de projet complète avec Kanban
- **Trello-like :** Leantime, Focalboard, TaskBoard
### Propriétaires
- **Trello** (Atlassian)
- **Notion Kanban**
- **Asana**
- **Monday.com**
- **ClickUp**
## 🔐 Sécurité
- ✅ Authentification 2FA, LDAP/SAML/OAuth2
- ⚠️ La version Meteor expose un grand nombre de fichiers statiques : **bien mettre derrière un reverse-proxy**
- ✅ Mettre à jour régulièrement (snapshots Docker fréquents)
- ⚠️ WeKan n'inclut pas de chiffrement au repos : sécuriser le volume MongoDB
-`WRITABLE_PATH` doit pointer sur un volume persistant
- ✅ Sauvegardes MongoDB + test de restauration
## 📚 Ressources
- [Site officiel WeKan](https://wekan.github.io/)
- [Wiki Docker officiel](https://github.com/wekan/wekan/wiki/Docker)
- [GitHub wekan/wekan](https://github.com/wekan/wekan)
- [Sandstorm WeKan](https://github.com/wekan/wekan-sandstorm)
- [Communauté francophone](https://github.com/wekan/wekan/discussions)
## Pages Liées
- [[cat-kanban]] — Catégorie Kanban
- [[recettes-docker-compose]] — Templates Docker Compose
- [[app-planka]] — Alternative moderne
- [[app-4ga-boards]] — Fork activement maintenu
- [[app-kanboard]] — Alternative PHP plus légère