« Trace install tas - msgvault » : différence entre les versions
hermes |
hermes |
||
| Ligne 12 : | Ligne 12 : | ||
== Exécution / runtime == | == Exécution / runtime == | ||
Quadlets msgvault.container, msgvault.network et msgvault-data.volume; conteneur msgvault, unité systemd utilisateur msgvault.service. Image ghcr.io/kenn-io/msgvault:stable, version vérifiée v0.21.0 (2026-10-05). Le serveur msgvault serve est démarré par l’image. | Quadlets msgvault.container, msgvault.network et msgvault-data.volume; conteneur msgvault, unité systemd utilisateur msgvault.service. Image ghcr.io/kenn-io/msgvault:stable, version vérifiée v0.21.0 (2026-10-05). Le serveur msgvault serve est démarré par l’image. UserNS=keep-id garde l’accès aux fichiers hôtes appartenant à Loïc tout en préservant le mode de montage en lecture seule de /imports. | ||
== Chemins de configuration == | == Chemins de configuration == | ||
Dernière version du 5 octobre 2026 à 00:36
Trace install tas - msgvault
Rôle
Archive locale et consultable de courriels, dont les PST Outlook, conservée sur tas.
Accès
- Local : http://127.0.0.1:8110
- Public : aucun; port publié uniquement sur la boucle locale.
Ports
127.0.0.1:8110 côté hôte vers 8080/tcp dans le conteneur; aucun port public/Caddy.
Exécution / runtime
Quadlets msgvault.container, msgvault.network et msgvault-data.volume; conteneur msgvault, unité systemd utilisateur msgvault.service. Image ghcr.io/kenn-io/msgvault:stable, version vérifiée v0.21.0 (2026-10-05). Le serveur msgvault serve est démarré par l’image. UserNS=keep-id garde l’accès aux fichiers hôtes appartenant à Loïc tout en préservant le mode de montage en lecture seule de /imports.
Chemins de configuration
- /home/loic/.config/containers/systemd/msgvault.container
- /home/loic/.config/containers/systemd/msgvault.network
- /home/loic/.config/containers/systemd/msgvault-data.volume
- Configuration source privée : /home/loic/msgvault-config/config.toml (mode 0600); fournie au conteneur par le secret Podman msgvault-config, monté en lecture seule sous /data/config.toml. La clé API ne doit pas être publiée dans le wiki.
Volumes / persistance
- Volume Podman msgvault-data:/data : base, pièces jointes et index/cache analytiques.
- /home/loic/msgvault-imports/ monté en lecture seule dans le conteneur sous /imports; y déposer les PST d’entrée. L’import ne modifie pas le fichier source.
- Réseau dédié Podman msgvault-net.
Dépendances
- Image GHCR ghcr.io/kenn-io/msgvault, canal stable.
- Mises à jour via AutoUpdate=registry et le timer utilisateur podman-auto-update.timer (contrôlé actif le 2026-10-05).
Importer et analyser un PST
Déposer l’archive sur l’hôte dans /home/loic/msgvault-imports/, puis lancer l’import avec l’adresse associée au PST et le nom de fichier réel :
podman exec msgvault msgvault import-pst identifiant@example.com /imports/mon-archive.pst
L’import PST est reprenable, transforme les dossiers en labels et importe les e-mails; calendrier, contacts, tâches et notes sont ignorés. Après l’import, consulter les statistiques avec podman exec msgvault msgvault stats, rechercher avec podman exec msgvault msgvault search from:contact@example.com, ou ouvrir l’interface locale sur http://127.0.0.1:8110 (clé API privée dans le fichier de configuration source).
L’import PST n’effectue pas d’OCR des pièces jointes. L’indexation documentaire est un traitement distinct, optionnel, nécessitant la configuration d’un fournisseur, une sonde de capacité et un consentement explicite; cette fonction n’est pas activée.
Remarques
L’import PST ne se déclenche pas automatiquement lorsqu’un fichier est déposé. Ne pas exposer le port via Caddy sans décision spécifique et configuration HTTPS/authentification. Le canal stable autorise la mise à jour automatique quotidienne, mais une mise à jour peut inclure une migration de base : sauvegarder l’archive avant mise à niveau importante.
Données / emplacements à sauvegarder
- Volume msgvault-data.
- /home/loic/msgvault-config/config.toml (confidentiel) et secret Podman msgvault-config.
- /home/loic/msgvault-imports/ pour conserver les PST originaux.
Sauvegarde
Utiliser le mécanisme de backup Msgvault puis vérifier le dépôt. Sauvegarder séparément le fichier de configuration privé et les PST d’origine. Pour une sauvegarde brute du volume, arrêter le service et préserver les propriétaires/permissions.
Restauration
Restaurer le volume msgvault-data, la configuration privée et le secret Podman; remettre les PST dans le répertoire d’import si une réimportation est nécessaire, puis lancer systemctl --user daemon-reload et systemctl --user start msgvault.service.
Maintenance documentaire
Mettre à jour cette page si changent l’image/version, les montages, le port, la politique de mise à jour, la configuration ou le workflow d’import.
Trace documentaire
Cette page fait partie de Trace install tas.