1. À quoi ça sert
Par défaut, les agents et le poste passent par Pitflow :
- Console :
https://pitflow.fr/{slug}/app/ - PWA :
https://pitflow.fr/{slug}/pwa/
Vous pouvez ajouter un nom de domaine à vous. L’environnement s’ouvre alors sur ce domaine, sans le slug dans l’adresse :
- Console :
https://votre-domaine.tld/app/ - PWA :
https://votre-domaine.tld/pwa/
Le panel (factures, licences, téléchargements, paramètres) reste sur pitflow.fr. Le domaine perso ne remplace pas le panel.
Les URL pitflow.fr/{slug}/… restent valides. Tant que le DNS n’est pas vert, c’est celles-là qu’il faut donner.
2. Brancher le domaine
Panel → Paramètres
Champ Domaine personnalisé : uniquement le nom d’hôte, sans https:// ni chemin. Exemple : mairie.fr ou pitflow.mairie.fr.
DNS chez votre registrar
CNAME (ou ALIAS / flattening sur un domaine racine) vers clients.pitflow.fr. En cas de panne d’un serveur Pitflow, l’IP change côté Pitflow : vous n’avez rien à retoucher.
TXT de vérification
Enregistrement _pitflow-verify (valeur affichée dans Paramètres). Sans ce TXT, le domaine n’est pas validé.
Vérifier
Bouton Vérifier dans Paramètres. Le certificat HTTPS est émis une fois le DNS bon. Un diagnostic (DNS, nginx, certificat) est disponible si besoin.
3. Chemin de base (optionnel)
Champ Base path. Utile si le domaine sert déjà autre chose.
Exemple : domaine mairie.fr, base path pitflow →
- Console :
https://mairie.fr/pitflow/app/ - PWA :
https://mairie.fr/pitflow/pwa/
Sans base path, console et PWA sont à la racine du domaine (/app/ et /pwa/).
4. Apps natives et pairing
Le QR / lien Téléchargement emporte l’URL publique de l’environnement. Si le domaine perso est actif, l’app Android, iOS ou Desktop ouvre cette adresse, pas pitflow.fr/{slug}.
La PWA installée depuis le navigateur doit l’être depuis l’URL du domaine perso si c’est celle que les agents utilisent (sinon l’icône pointera encore vers Pitflow).
5. Ce qui ne change pas
- Comptes agents, permissions, carte, messagerie : identiques.
- Un seul environnement par domaine (le nom d’hôte est unique).
- Le slug interne ne disparaît pas : il sert toujours côté Pitflow et dans le panel.