Protégez les accès.
HTTPS, hôtes explicites et base sans port public. Activez la double authentification et la vérification récente des administrateurs.
Sécurité et second facteurAUTO-HÉBERGER ZEFACTURE
Installez ZeFacture sur votre infrastructure et administrez vos données, vos accès et vos sauvegardes. Le guide vous accompagne du premier démarrage à l’exploitation.
Ces commandes utilisent les sources Django de la candidate 0.1.0-rc.1. Une instance existante propose son code dans /source. Code et distribution
CHOISISSEZ VOTRE POINT DE DÉPART
POUR DÉCOUVRIR LE LOGICIEL
Depuis le dossier django/ des sources, générez la configuration puis lancez Docker. Le premier compte est créé depuis le terminal.
La procédure détailléecd django
python3 tools/configure.py
docker compose up -d --build
docker compose exec web python manage.py bootstrap --email vous@example.comOuvrez http://127.0.0.1:8090. Le mot de passe du premier compte est demandé dans le terminal ; aucun compte par défaut n’existe.
POUR UNE NOUVELLE INSTALLATION
Préparez le DNS et ouvrez les ports 80/443. Depuis django/, générez une configuration avec votre domaine. Complétez l’identité et le contact de l’exploitant dans le fichier privé avant le démarrage.
La procédure détailléecd django
python3 tools/configure.py --production --domain factures.example.com
# Compléter .env avec les coordonnées réelles de l’exploitant
docker compose --profile https up -d --build
docker compose exec web python manage.py bootstrap --email vous@example.com
docker compose exec web python manage.py check --deploy
docker compose exec web python manage.py check_readiness --production --require-oauthRemplacez factures.example.com par votre domaine. Caddy gère les certificats. La configuration OAuth, la MFA, la messagerie et les sauvegardes se complètent dans le guide avant ouverture.
POUR CONSERVER LES DONNÉES EXISTANTES
Depuis le dossier Django de l’instance source, créez une sauvegarde complète. Transférez-la par un canal privé, puis restaurez-la sur le serveur cible avec les mêmes sources.
La procédure détaillée# Sur la source, depuis django/
python3 tools/backup.py --project zefacture --output backups/avant-transfert.tar.gz
# Sur la cible, depuis django/ : projet sans volumes existants
python3 tools/restore.py /chemin/prive/avant-transfert.tar.gz --project zefacture-prod --port 8090La restauration conserve les clés et verrouille emails, webhooks et services externes. Le worker reste arrêté. Validez les documents et les files avant la bascule et suivez les paramètres Compose du guide.
SOUS LE CAPOT
Python et Django 5.2 LTS, PostgreSQL 17 et des traitements locaux. Le serveur web et le worker partagent la base et le stockage.
ADMINISTRER DANS LA DURÉE
HTTPS, hôtes explicites et base sans port public. Activez la double authentification et la vérification récente des administrateurs.
Sécurité et second facteurGardez la base, les fichiers, la configuration et app.key ensemble. Conservez une copie privée hors serveur et testez sa restauration.
Configurez SMTP ou vos applications Google/Microsoft pour les emails. Autorisez SUPERPDP par entreprise lorsque son circuit vous concerne.
Configuration des connexionsSauvegardez avant de changer les sources, reconstruisez les images et vérifiez les migrations. Le retour arrière utilise une restauration séparée.
Procédure de mise à jourAVANT D’OUVRIR VOTRE INSTANCE
Une première liste pour préparer la recette. Vos coches sont enregistrées uniquement dans ce navigateur.
0 / 6 points vérifiés
La recette complète avant ouvertureLE MANUEL D’EXPLOITATION
DNS, HTTPS, reprise de l’existant, Google, Microsoft, secrets, sauvegardes, CI et dépannage : retrouvez la procédure complète.