# Maarch Courrier
# Redémarrer Maarch Courrier
En cas de problème (VM éteinte, conteneur qui plante ..) il faut redémarrer Maarch de la manière suivante :
Trouver le dossier dans lequel est stocké docker-compose.yaml, puis docker-compose down et docker compose up -d
Dans notre cas (en root)
`cd /var/maarch/client-deployments`
`docker compose down`
`docker compose up -d`# Changer le certificat docapost .p12
Ce certificat sert à nous authentifier auprès de Fast Parapheur lors de l’envoi en signature d’un document. Sa clé publique doit leur être envoyé préalablement à `assistance.fast@docaposte.fr`
Le fichier de configuration se situe dans
`/var/maarch/MaarchCourrier/custom/cs_courrier/modules/visa/xml/remoteSignatoryBooks.xml` :
[](https://formagent.vincennes.fr/uploads/images/gallery/2025-10/image-1759419924221.png)
Modifier le certPath pour le faire correspondre au chemin du nouveau certificat .p12 en remplaçant
/var/maarch/MaarchCourrier/
par
/var/www/html/MaarchCourrier
( car le .p12 sera lu par le conteneur "courrier" et ce dernier voit le chemin de cette manière).
Modifier certPass pour le faire correspondre au nouveau mot de passe.
Si le mot de passe contient des caractères spéciaux, il faut les remplacer par leur entité HTML. Par exemple `&` devient `&` et `"` devient `"` .
Terminé. Pas besoin de redémarrer.# Changer le certificat SSL
Les chemins des certificats sont à changer dans
/etc/apache2/sites-available/maarch-ssl.conf et
/etc/apache2/sites-available/pnlyoffice-ssl.conf
puis redémarrer apache2 :
`sudo service apache2 restart`# Maarch Capture
Au démarrage de la VM, elle monte un dossier partagé entre le répertoire où sont scannés les documents du service courrier (//chronos.vincennes.fr/services/moyens\_generaux/scan/maarch\_capture)
et le dossier où Maarch Capture récupère automatiquement les fichiers (/var/maarch/MaarchCapture/files/maarch\_capture) toutes les minutes.# Mettre à jour l’application
Ne nécessite pas d’arrêt de l’application.
Sur le serveur , en root :
`cd /var/maarch/client-deployments`
`git status`
`git config core.fileMode false`
`git stash`
`git fetch`
`git branch`
`git config --global --add safe.directory /var/maarch/MaarchCourrier`
`git checkout tags/2301.4.7 -b 2301.4.7`
`git status`
`git stash apply`
Les tags des nouvelles versions sont disponibles ici :
[**https://labs.maarch.org/maarch/MaarchCourrier/-/tags**](https://labs.maarch.org/maarch/MaarchCourrier/-/tags)# Notifications mails
Les notifications mails sont envoyées toutes les 30 minutes grâce à un script dans le conteneur "courrier" :
`/var/www/html/MaarchCourrier/custom/cs_courrier/bin/notification/scripts/notification_cs_courrier_BASKETS.sh`
Une tâche cron exécute ce script toutes les 30 minutes avec l'utilisateur "www-data".
Il est possible de lister les tâches cron en se connectant au conteneur avec l'utilisateur www-data et en tapant
` cat /etc/cron.d/courrier`
L'exécution de ce script est parfois bloqué pour éviter qu'il ne soit lancé plusieurs fois à la suite grâce à un système de verrouillage:
`/var/www/html/MaarchCourrier/bin/notification/cs_courrierprocess_email_stack.lck`
Nous avons ajouté un script:
` /var/www/html/MaarchCourrier/bin/notification/scripts/delete_lck.sh`
Il supprime tous les .lck de + de 30 minutes d'âge situés dans
` /var/www/html/MaarchCourrier/bin/notification/`
Le script est lancé périodiquement grâce à un cron de l'utilisateur www-data.# Ajout d'un champ personnalisé
dans Administration champs personnalisés :
cliquer sur le + du type de champ que vous souhaitez ajouter :
[](https://formagent.vincennes.fr/uploads/images/gallery/2025-12/image-1766485576694.png)
dans le cas d'une liste de choix, indiquer les choix
[](https://formagent.vincennes.fr/uploads/images/gallery/2025-12/image-1766485533219.png)
Administration > Modèles d'enregistrement : choisir le formulaire
[](https://formagent.vincennes.fr/uploads/images/gallery/2025-12/image-1766488328381.png)
Glisser déposer le champs dans la section où l'on souhaite le faire apparaitre :
[](https://formagent.vincennes.fr/uploads/images/gallery/2025-12/image-1766488416962.png)
Si on veut rendre obligatoire :
[](https://formagent.vincennes.fr/uploads/images/gallery/2025-12/image-1766488504074.png)
si on veut pré-remplir avec la date du jour cliquer sur la cloche devant le champ date
[](https://formagent.vincennes.fr/uploads/images/gallery/2025-12/image-1766488677627.png)
Cliquer sur "Modifier" pour enregistrer :
[](https://formagent.vincennes.fr/uploads/images/gallery/2025-12/image-1766488894518.png)