# La Suite Docs — Scalable Collaborative Wiki & Documentation Platform

> An open-source collaborative note-taking, wiki, and documentation platform built with Django and React, designed for teams and organizations that need real-time editing at scale.

## Install

Save as a script file and run:

# La Suite Docs — Scalable Collaborative Wiki & Documentation Platform

## Quick Use
```bash
git clone https://github.com/suitenumerique/docs.git
cd docs
make install
make run
# Open http://localhost:8071
```

## Introduction
La Suite Docs is an open-source collaborative note-taking, wiki, and documentation platform built by the French government's Suite Numerique initiative. It provides real-time co-editing powered by Yjs, a Django backend, and a React frontend with BlockNote editor, scaling to thousands of concurrent users.

## What La Suite Docs Does
- Provides real-time collaborative document editing with conflict-free CRDT synchronization
- Organizes content into workspaces, folders, and pages with granular access controls
- Supports rich text editing via BlockNote with slash commands and markdown shortcuts
- Enables team collaboration with comments, mentions, and version history
- Offers full-text search across all documents in your organization

## Architecture Overview
La Suite Docs uses a Django REST backend with PostgreSQL for metadata and access control, while real-time collaboration is handled through a Yjs WebSocket server that synchronizes document state across clients using CRDTs. The React frontend uses the BlockNote rich-text editor. Media assets are stored in S3-compatible object storage. Authentication integrates with OpenID Connect providers.

## Self-Hosting & Configuration
- Deploy with Docker Compose using the provided `docker-compose.yml` for PostgreSQL, Redis, and the app services
- Configure `OIDC_OP_*` environment variables to connect your identity provider for SSO
- Set `AWS_S3_*` variables to point to your S3-compatible bucket for file storage
- Adjust `COLLABORATION_WS_URL` to your WebSocket server endpoint for real-time editing
- Use the Django admin panel at `/admin` to manage users, teams, and workspace permissions

## Key Features
- CRDT-based real-time collaboration that works reliably even on unreliable networks
- Government-grade security with fine-grained RBAC and audit logging
- MIT licensed with no vendor lock-in or usage restrictions
- Offline-capable editing that syncs when connectivity returns
- Lightweight deployment footprint compared to Confluence or SharePoint

## Comparison with Similar Tools
- **Outline** — Markdown-only editor; Docs offers a richer BlockNote block editor with slash commands
- **BookStack** — Chapter/book hierarchy is rigid; Docs uses flexible workspace/folder structure
- **Wiki.js** — Strong for public wikis; Docs focuses on team collaboration with real-time co-editing
- **HedgeDoc** — Great for single-document collaboration; Docs adds workspace organization and RBAC
- **Docmost** — Newer alternative; Docs has a larger community and government backing

## FAQ
**Q: Does La Suite Docs support markdown?**
A: Yes. The BlockNote editor supports markdown shortcuts for headings, lists, code blocks, and inline formatting while providing a visual editing experience.

**Q: Can I migrate from Notion or Confluence?**
A: There is no built-in importer yet, but the REST API allows programmatic content creation, and community migration scripts are available.

**Q: What authentication methods are supported?**
A: La Suite Docs supports OpenID Connect, which covers providers like Keycloak, Auth0, Google Workspace, and Azure AD.

**Q: How many concurrent editors can it handle?**
A: The Yjs collaboration server scales horizontally. Deployments in the French government serve thousands of simultaneous editors across hundreds of documents.

## Sources
- https://github.com/suitenumerique/docs
- https://lasuite.numerique.gouv.fr

---
Source: https://tokrepo.com/en/workflows/eeecc6ba-407f-11f1-9bc6-00163e2b0d79
Author: Script Depot