Folio Writer
Bientôt

Auto-héberger Folio Writer Cloud

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.

Pas encore tout à fait disponible

L’image publique foliowriter/folio-web est encore en cours de finition : les commandes ci-dessous ne téléchargeront rien pour l’instant. Cette page donne un aperçu du fonctionnement de l’auto-hébergement. Vous voulez être prévenu le jour de sa sortie ? Faites-le-nous savoir et nous vous enverrons un e-mail.

Démarrage rapide

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.

Ce qu’il vous faut

Votre premier compte (administrateur)

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.

Configuration

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
VariableRôle
FOLIO_DOMAINDomaine que Caddy sert et pour lequel il obtient des certificats (par défaut localhost).
PUBLIC_BASE_URLOrigine absolue utilisée dans les e-mails de connexion et les liens de partage.
FOLIO_ADMIN_EMAILSAdresses e-mail séparées par des virgules, toujours administratrices — exemptées de quota, peuvent utiliser /admin.
SMTP_HOST / PORT / USER / PASS / SECURE / FROMCourrier sortant pour la connexion par lien magique. Non défini → les liens s’affichent dans le journal du conteneur.
FOLIO_LIMIT_PROJECTSProjets par compte (2 par défaut). 0 = illimité — c’est le réglage de la plupart des auto-hébergeurs.
FOLIO_LIMIT_STORAGE_MBStockage par compte, en Mo (50 par défaut). 0 = illimité.
FOLIO_DEMOSIdentifiants de projets, séparés par des virgules, proposés comme bacs à sable de démonstration réinitialisés automatiquement.
FOLIO_ALLOW_GUEST_PROJECTSDé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_KEYClé de 64 caractères hexadécimaux qui chiffre au repos les secrets d’authentification enregistrés.

Mises à jour, sauvegarde & restauration

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.

Licence

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.