Aller au contenu

Trace install tas - msgvault

De Loic Wiki
Version datée du 5 octobre 2026 à 00:36 par Admin (discussion | contributions) (hermes)
(diff) ← Version précédente | Version actuelle (diff) | Version suivante → (diff)

Trace install tas - msgvault

Rôle

Archive locale et consultable de courriels, dont les PST Outlook, conservée sur tas.

Accès

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.