Un seul fichier docker compose suffit pour faire tourner sur votre propre machine le même serveur que celui de cloud.foliowriter.app : coédition en direct, projets chiffrés de bout en bout, aperçu composé et export PDF / Word / LaTeX — Pandoc et Typst sont inclus dans l’image. Gratuit pour un usage personnel.
mkdir folio && cd folio
curl -fsSLO https://foliowriter.app/selfhost/docker-compose.yml
FOLIO_DOMAIN=folio.example.com docker compose up -d
Le Caddy fourni obtient et renouvelle le certificat Let’s Encrypt de votre domaine, et sert de proxy pour le HTTPS ainsi que pour les websockets de collaboration. Ouvrez ensuite https://folio.example.com. Pas encore de domaine ? docker compose up folio-web, puis ouvrez http://localhost:8787.
foliowriter/folio-web est publiée pour amd64 et arm64.Démarrez le serveur avec votre adresse e-mail dans FOLIO_ADMIN_EMAILS :
FOLIO_DOMAIN=folio.example.com FOLIO_ADMIN_EMAILS=you@example.com \
docker compose up -d
Chaque adresse indiquée là est toujours administratrice — aucun quota, et accès au tableau de bord /admin (comptes, projets, stockage, trafic). Connectez-vous avec cette adresse ; si aucun SMTP n’est configuré, le lien de connexion magique s’affiche dans le journal du serveur au lieu d’être envoyé par e-mail :
docker compose logs folio-web | grep -i http
Ouvrez le lien affiché et vous voilà connecté. Pour un véritable envoi d’e-mails, définissez les variables SMTP_* — n’importe quel relais convient — ainsi que PUBLIC_BASE_URL, pour que les liens envoyés par e-mail utilisent votre domaine.
Tout passe par des variables d’environnement. Placez-les dans un fichier .env à côté de docker-compose.yml (Compose le lit automatiquement) :
FOLIO_DOMAIN=folio.example.com
PUBLIC_BASE_URL=https://folio.example.com
FOLIO_ADMIN_EMAILS=you@example.com
FOLIO_LIMIT_PROJECTS=0 # 0 = unlimited
FOLIO_LIMIT_STORAGE_MB=0 # 0 = unlimited
FOLIO_ENC_KEY=… # openssl rand -hex 32
| Variable | Rôle |
|---|---|
FOLIO_DOMAIN | Domaine que Caddy sert et pour lequel il obtient des certificats (par défaut localhost). |
PUBLIC_BASE_URL | Origine absolue utilisée dans les e-mails de connexion et les liens de partage. |
FOLIO_ADMIN_EMAILS | Adresses e-mail séparées par des virgules, toujours administratrices — exemptées de quota, peuvent utiliser /admin. |
SMTP_HOST / PORT / USER / PASS / SECURE / FROM | Courrier sortant pour la connexion par lien magique. Non défini → les liens s’affichent dans le journal du conteneur. |
FOLIO_LIMIT_PROJECTS | Projets par compte (2 par défaut). 0 = illimité — c’est le réglage de la plupart des auto-hébergeurs. |
FOLIO_LIMIT_STORAGE_MB | Stockage par compte, en Mo (50 par défaut). 0 = illimité. |
FOLIO_DEMOS | Identifiants de projets, séparés par des virgules, proposés comme bacs à sable de démonstration réinitialisés automatiquement. |
FOLIO_ALLOW_GUEST_PROJECTS | Définissez 1 pour permettre aux visiteurs de créer des projets sans se connecter (par défaut, la création exige un compte ; les démos sont toujours ouvertes). |
FOLIO_ENC_KEY | Clé de 64 caractères hexadécimaux qui chiffre au repos les secrets d’authentification enregistrés. |
Mise à jour : docker compose pull && docker compose up -d. Des versions étiquetées existent (foliowriter/folio-web:0.2.0) si vous préférez épingler une version plutôt que suivre latest.
Tout — projets, comptes, sessions — se trouve dans ./data, à côté du fichier compose. La sauvegarde, c’est ce seul dossier :
docker compose stop folio-web
tar czf folio-backup-$(date +%F).tgz data
docker compose start folio-web
Pour restaurer — ou changer de serveur —, remettez data/ en place et lancez docker compose up -d.
L’usage personnel est gratuit. L’image est propriétaire, mais l’auto-héberger ne coûte rien pour vous-même, votre famille et vos collaborateurs personnels.
Les équipes et les organisations ont besoin d’une licence commerciale. L’exploiter pour ou au sein d’une entreprise, d’un établissement d’enseignement ou de toute autre organisation — ou à des fins commerciales — en exige une ; c’est ce qui permet de financer l’offre gratuite. Contactez-nous et nous réglerons cela rapidement.
Pas de redistribution, de changement de marque ni d’œuvres dérivées ; les conditions complètes accompagnent la documentation de l’image. Vous préférez ne pas gérer de serveur du tout ? cloud.foliowriter.app en est la version hébergée — gratuite pour commencer.