Installation étape par étape

Toute l’installation se fait avec une seule commande, ./draften install, lancée dans le paquet décompressé. Voici la marche à suivre, d’un serveur vide jusqu’à la première connexion. Ce que contient une installation et où se trouve chaque chose est décrit dans Installer sur votre propre serveur.

Étape 1 : préparer le serveur

• x86-64 sous Linux (un Synology ou un autre NAS avec Docker convient aussi),
• Docker Engine 24 ou plus récent avec le plugin compose – vérifiez avec docker compose version,
• 4 Go de mémoire et 20 Go d’espace disque,
• les outils tar, base64 et sha256sum (ou shasum), présents sur presque tous les systèmes.

Le serveur n’a pas besoin d’internet pour l’installation : le paquet apporte toutes les images.

Étape 2 : vérifier que le paquet vient de nous

Pour chaque paquet de version draften-<version>.tar, nous publions sa somme de contrôle. Calculez-la et comparez :

sha256sum draften-<version>.tar

Chaque mise à jour ultérieure, l’installation la vérifie elle-même avec nos clés. La première installation, elle, n’a rien à quoi se comparer – c’est ce contrôle qui en tient lieu. Si les sommes de contrôle diffèrent, n’installez pas le paquet et contactez-nous.

Étape 3 : décompresser le paquet et lancer l’installateur

Choisissez le répertoire dans lequel l’installation résidera, décompressez-y le paquet et lancez l’installateur :

mkdir /srv/draften
tar -xf draften-<version>.tar -C /srv/draften
cd /srv/draften
./draften install

L’installateur charge les images, vérifie le paquet et demande ce dont il a besoin.

Étape 4 : répondre aux questions de l’installateur

• L’adresse à laquelle les gens ouvrent draften, par exemple https://draften.firma.cz. Ce doit être l’adresse qu’ils utilisent réellement – les adresses de redirection pour la connexion avec Microsoft et Google sont construites à partir d’elle.
• L’organisation et son nom court (lettres minuscules, chiffres, traits d’union).
• Le premier administrateur : e-mail, nom et langue (cs ou en). Il devient propriétaire de l’organisation et exploitant de toute l’installation.
• L’updater (oui / non) – un service qui permet de mettre à jour, de changer le nombre de processus et de remplacer la clé de chiffrement depuis l’interface web. Il a accès à Docker, ce qui équivaut aux droits root sur cette machine. Sans lui, tout fonctionne en ligne de commande.
• Le certificat HTTPS – le fichier du certificat et sa clé (PEM), si HTTPS doit se terminer directement dans draften. Laissez vide lorsqu’un reverse proxy ou un tunnel placé devant draften se charge de HTTPS (voir l’étape 7).

Chaque réponse peut aussi être donnée directement dans la commande, ce qui permet de scripter l’installation ; ./draften help liste les options. Par exemple :

./draften install --url https://draften.firma.cz --org "Firma SARL" \
  --admin-email jan@firma.cz --admin-name "Jan Novák" --locale cs --updater yes

Étape 5 : conserver une copie de .env hors du serveur

L’installateur écrit les paramètres et les secrets dans le fichier .env du répertoire d’installation. Copiez-le – au moins la valeur de MASTER_KEY – en lieu sûr, hors du serveur. Cette clé chiffre les accès aux boîtes mail, les clés des modèles et les mots de passe pour l’envoi des e-mails. Sans elle, personne ne peut les lire, pas même depuis une sauvegarde – et nous ne l’avons pas.

Étape 6 : définir votre mot de passe et vous connecter

À la fin, l’installateur affiche un lien pour définir le mot de passe du premier administrateur. Ouvrez-le dans un navigateur, définissez le mot de passe et vous êtes connecté. Le lien ne fonctionne qu’une fois et reste valable 7 jours. La page du mot de passe est présentée dans le guide Se connecter à draften.

Seul l’installateur affiche le lien. Ne le copiez nulle part et ne le transmettez pas – quiconque le possède définit le mot de passe de l’administrateur.

Étape 7 : publier l’adresse

Selon ce que vous avez choisi à l’étape 4 :

• Avec un certificat, draften écoute lui-même sur le port 443 et redirige du port 80 vers HTTPS. Il suffit que l’adresse pointe vers ce serveur dans le DNS.
• Sans certificat, draften écoute sur 127.0.0.1:8085 et votre reverse proxy ou tunnel placé devant lui termine HTTPS. Quand le proxy tourne sur une autre machine, définissez WEB_BIND=0.0.0.0:8085 dans .env.
• Avec un Cloudflare Tunnel, aucun port ouvert n’est nécessaire : placez le jeton du tunnel dans .env (CLOUDFLARE_TUNNEL_TOKEN), ajoutez tunnel à COMPOSE_PROFILES (par exemple COMPOSE_PROFILES=updater,tunnel) et lancez docker compose up -d. Dans Cloudflare, faites pointer le tunnel vers http://127.0.0.1:8085.

Un certificat peut aussi être ajouté plus tard :

./draften certificate cert.pem key.pem --url https://draften.firma.cz

Étape 8 : importer la licence

Nous envoyons la licence sous la forme d’un fichier licence-<numéro>.json. Dans l’interface, ouvrez Installation → Installation, choisissez le fichier dans la carte Licence en bas de la page et importez-le. Tant que l’installation n’a pas de licence, les assistants ne traitent aucun e-mail et aucune boîte mail ni aucun assistant ne peut être créé. Plus d’informations dans La licence.

Étape 9 : définir les clés et l’envoi des e-mails par défaut

Sur la même page Installation, définissez les Clés API par défaut pour les modèles et l’Envoi des e-mails par défaut (d’où partent les invitations et les liens de mot de passe). Ils s’appliquent à toute organisation qui ne définit pas les siens. Détails : Clés API des modèles et Envoi des e-mails.

Étape 10 : connecter une boîte mail et configurer un assistant

À partir d’ici, vous continuez comme sur n’importe quelle autre installation :

1. Ajoutez et connectez une boîte mail.
2. Configurez un assistant avec la mise en route.
3. Invitez d’autres personnes – Personnes et rôles.

Étape 11 : vérifier que tout fonctionne

./draften status

affiche la version, l’état de santé du web et des workers, l’état HTTPS et les dumps de la base de données. Dans l’interface, la page Exploitation indique si les workers se signalent – voir Exploitation et capacité.

Pour aller plus loin

• Mettre à jour avec l’updater – une nouvelle version en un clic,
• Mettre à jour en ligne de commande,
• Sauvegarde et restauration,
• Résolution des problèmes.