Pour les administrateurs
← Tous les sujets

Installation étape par étape

Le guide complet – télécharger et vérifier le paquet, ./draften install, HTTPS, la licence, les e-mails et la sécurisation du serveur.

Toute la marche à suivre, d’un serveur vide jusqu’à une exploitation sécurisée : téléchargement du paquet, installation, HTTPS, première connexion, paramétrage et sécurisation du serveur. Ce que le serveur doit remplir est décrit dans Environnement pris en charge ; de quoi se compose une installation, dans Installer sur votre propre serveur.

Avant de commencer

Préparez :

Étape 1 : préparer le serveur

Installez Docker Engine avec le plugin compose. Sur Ubuntu, depuis le dépôt officiel de Docker :

sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Sur d’autres distributions, suivez https://docs.docker.com/engine/install/. Le paquet docker.io des dépôts de la distribution est souvent ancien et n’a pas le plugin compose.

Vérifiez les versions – Docker doit être en version 24 ou plus récente et docker compose doit répondre :

docker version --format '{{.Server.Version}}'
docker compose version

Étape 2 : télécharger le paquet

Le paquet se télécharge depuis download.draften.ai avec la clé contenue dans le fichier de licence. Ces commandes extraient la clé de la licence et affichent les versions disponibles :

KEY=$(sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' licence-<numéro>.json | tr '_-' '/+' | awk '{ while (length($0) % 4) $0 = $0 "="; print }' | base64 -d | sed -n 's/.*"key": *"\([^"]*\)".*/\1/p')
curl -fsS -H "Authorization: Bearer $KEY" https://download.draften.ai/v1/latest.json | sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' | tr '_-' '/+' | awk '{ while (length($0) % 4) $0 = $0 "="; print }' | base64 -d

La liste affiche les versions des six derniers mois – pour chacune la version, la date, les notes, la taille et la somme de contrôle sha256 – et, sous latest, la plus récente qui n’a pas été retirée. Téléchargez cette version :

curl -fS -H "Authorization: Bearer $KEY" -o draften-<version>.tar https://download.draften.ai/v1/bundles/draften-<version>.tar

Le paquet pèse environ 500 Mo. Si la passerelle répond par une erreur 403, la licence est inconnue, révoquée ou expirée – le message indique pourquoi.

Serveur sans internet : téléchargez le paquet sur une autre machine avec les mêmes commandes et transférez-le sur le serveur (par exemple avec scp). Dans ce cas, nous pouvons aussi vous envoyer la somme de contrôle avec le paquet.

Étape 3 : vérifier le paquet

Calculez la somme de contrôle et comparez-la à la valeur sha256 de cette version dans la liste de l’étape 2 :

sha256sum draften-<version>.tar

Si les sommes diffèrent, n’installez pas le paquet et contactez-nous. C’est le seul contrôle manuel : chaque mise à jour ultérieure, l’installation la vérifie elle-même avec nos clés.

Étape 4 : 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 :

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

L’installateur charge d’abord les images (une minute ou deux) et vérifie la signature et le contenu du paquet. Si la vérification échoue (« this bundle does not check out »), le paquet est endommagé – téléchargez-le à nouveau.

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

L’installateur pose ses questions en anglais :

QuestionCe qu’il faut saisir
Where will people open draften (the full address)l’adresse avec https://, par exemple https://draften.firma.cz. Ce doit être l’adresse que les gens utilisent réellement – les adresses de redirection pour la connexion avec Microsoft et Google sont construites à partir d’elle
The organisation's namele nom de votre organisation
Its short nameun nom court : lettres minuscules, chiffres et traits d’union. L’installateur le propose à partir du nom de l’organisation
The first administrator's e-maill’e-mail du premier administrateur. Il devient propriétaire de l’organisation et exploitant de toute l’installation
Their nameson nom
Their languagecs, en, de, fr, es, it, pt ou pl (par défaut en)
Run the updateryes ou no (par défaut yes). L’updater permet de mettre à jour, de changer le nombre de processus, de remplacer la clé de chiffrement et de sauvegarder depuis l’interface web. Il a accès à Docker, ce qui équivaut aux droits root sur le serveur. Sans lui, tout se fait en ligne de commande
HTTPS certificate file (PEM)le chemin du certificat, si HTTPS doit se terminer directement dans draften ; sinon, laissez vide
Its private key filele chemin de la clé du certificat

Avec un certificat, l’adresse doit commencer par https://. Chaque réponse peut aussi être donnée directement dans la commande, ce qui permet de scripter l’installation ; ./draften help liste les options :

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

Étape 6 : ce que fait l’installateur

  1. Il écrit les paramètres et les secrets dans le fichier .env – lisible uniquement par son propriétaire. Il génère aléatoirement les mots de passe de la base de données, la clé de chiffrement MASTER_KEY et le secret des sessions, et ne les affiche nulle part.
  2. Il crée les dossiers data/ et backups/, ainsi que la première organisation avec son administrateur.
  3. Il démarre draften et vérifie qu’il répond.
  4. À la fin, il affiche l’adresse et le lien de définition du mot de passe du premier administrateur, et rappelle de conserver une copie de .env.

Si le premier démarrage échoue (« the first start failed »), consultez docker compose ps et docker compose logs. S’il n’affiche pas le lien, vous le trouvez avec la commande docker compose logs worker | grep set-password – le worker l’affiche à chaque démarrage tant que le mot de passe n’existe pas.

Conservez tout de suite une copie de .env hors du serveur – au moins la valeur de MASTER_KEY. 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 7 : publier draften en HTTPS

Choisissez une variante selon l’endroit où HTTPS se termine. Faites pointer l’enregistrement DNS de votre adresse vers le serveur (ou vers le proxy).

HTTPS directement dans draften

Si vous avez donné un certificat à l’installateur, draften écoute sur le port 443 et redirige du port 80 vers HTTPS. Il suffit du DNS et des ports 80 et 443 ouverts. Un certificat peut aussi être ajouté plus tard, et la même commande le remplace après un renouvellement sans perdre une seule requête :

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

Vous vous chargez vous-même du renouvellement du certificat (par exemple avec un client ACME) ; après chaque renouvellement, lancez cette commande.

Votre reverse proxy

Sans certificat, draften écoute uniquement sur 127.0.0.1:8085. Un proxy sur la même machine envoie les requêtes à cette adresse et transmet les en-têtes Host et X-Forwarded-Proto. Par exemple pour Caddy (qui se procure lui-même le certificat) :

draften.firma.cz {
    reverse_proxy 127.0.0.1:8085
}

ou pour nginx :

server {
    listen 443 ssl;
    server_name draften.firma.cz;
    ssl_certificate     /etc/ssl/draften/fullchain.pem;
    ssl_certificate_key /etc/ssl/draften/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8085;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Quand le proxy tourne sur une autre machine, définissez WEB_BIND=0.0.0.0:8085 dans .env, lancez sudo docker compose up -d et n’ouvrez le port 8085 qu’au proxy (voir l’étape 13).

Cloudflare Tunnel

Aucun port ouvert n’est nécessaire. Dans Cloudflare Zero Trust, créez un tunnel et copiez son jeton. Dans .env, ajoutez CLOUDFLARE_TUNNEL_TOKEN=<jeton>, complétez COMPOSE_PROFILES avec tunnel (par exemple COMPOSE_PROFILES=updater,tunnel) et lancez :

sudo docker compose up -d

Dans Cloudflare, ajoutez ensuite au tunnel une adresse publique (Public hostname) qui pointe vers http://127.0.0.1:8085. Laissez WEB_BIND sur 127.0.0.1:8085. Docker télécharge l’image cloudflared depuis Docker Hub – elle n’est pas dans le paquet.

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

Ouvrez le lien affiché par l’installateur, définissez le mot de passe et vous êtes connecté. Le lien ne fonctionne qu’une fois et reste valable 7 jours. La page de définition du mot de passe est présentée dans le guide Se connecter à draften.

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

Étape 9 : importer la licence

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éé. Avec la licence, l’updater surveille lui-même les nouvelles versions. Plus d’informations dans La licence.

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

Sur la même page Installation :

Étape 11 : connecter les e-mails et les personnes

  1. Décidez comment l’assistant accédera aux e-mails et préparez-le chez Microsoft ou Google : Microsoft 365, Google Workspace, autre boîte mail via IMAP.
  2. Si les membres doivent se connecter avec un compte Microsoft ou Google, configurez-le dans Comment les membres se connectent.
  3. Ajoutez et connectez une boîte mail.
  4. Configurez un assistant avec la mise en route.
  5. Invitez d’autres personnes – Personnes et rôles.

Étape 12 : vérifier que tout fonctionne

sudo ./draften status

affiche la version, l’état de santé du web et des workers, l’état HTTPS et les sauvegardes. Dans l’interface, la page Exploitation indique si les workers se signalent – voir Exploitation et capacité. Si quelque chose ne fonctionne pas, consultez Résolution des problèmes ; sudo ./draften diagnose crée un fichier pour notre support.

Étape 13 : sécuriser le serveur

Qui a accès au serveur a accès à tout : aux e-mails contenus dans les messages, à .env avec la clé et aux sauvegardes. Protégez donc le serveur comme un serveur de messagerie.

Pare-feu. De l’extérieur, n’ouvrez que le nécessaire :

Docker contourne les règles UFW (et firewalld) pour les ports qu’il publie. ufw deny 8085 ne ferme pas un port que Docker a ouvert sur 0.0.0.0. Laissez donc WEB_BIND sur 127.0.0.1:8085 partout où c’est possible ; sinon, limitez l’accès avec un pare-feu placé devant le serveur ou avec des règles dans la chaîne DOCKER-USER.

Pour les connexions sortantes, il suffit d’autoriser les adresses de l’Environnement pris en charge.

SSH. Connexion uniquement par clé (PasswordAuthentication no), sans connexion directe de root (PermitRootLogin no), administrateurs avec leurs propres comptes et sudo.

Qui a accès à Docker. L’appartenance au groupe docker équivaut aux droits root. Ne l’accordez qu’aux administrateurs du serveur.

Mises à jour du système. Activez les mises à jour de sécurité automatiques (sur Ubuntu unattended-upgrades) et mettez Docker à jour avec le système. Les mises à jour de draften sont assurées par l’updater – voir Mettre à jour avec l’updater.

Updater. Il a accès à Docker, ce qui équivaut aux droits root. Si vous n’en avez pas besoin, désactivez-le : retirez updater de COMPOSE_PROFILES dans .env et lancez sudo docker compose rm -sf updater dans le répertoire d’installation. Vous faites alors les mises à jour et les sauvegardes en ligne de commande.

Fichiers de l’installation. .env n’est lisible que par son propriétaire, le dossier backups/ aussi – laissez-les ainsi. Ne partagez pas le répertoire d’installation.

Sauvegardes hors du serveur. draften sauvegarde la base de données chaque jour dans backups/, sur le même disque. Organisez la copie de backups/ et de .env ailleurs, chiffrée – les dumps contiennent des e-mails. Détails : Sauvegarde et restauration.

Clé de chiffrement. Quand une personne qui connaissait .env s’en va, remplacez MASTER_KEY (sudo ./draften rotate-key, ou sous Installation) et conservez la nouvelle copie de .env hors du serveur.

Pour aller plus loin

Version texte