ObsiGate/TROUBLESHOOTING.md

Dépannage ObsiGate

Problème : Interface gèle lors de la sauvegarde des paramètres de fichiers cachés

Symptômes

• L'interface se fige quand vous cliquez sur "Sauvegarder" dans la section "Fichiers cachés"
• Le fichier vault_settings.json n'est pas créé dans /DOCKER_CONFIG/ObsiGate/data
• Aucun message d'erreur n'apparaît (ou message générique)

Cause

Le conteneur Docker n'a pas les permissions nécessaires pour écrire dans le répertoire /app/data (monté depuis /DOCKER_CONFIG/ObsiGate/data sur l'hôte).

Solution

1. Vérifier que le répertoire existe sur l'hôte

# Créer le répertoire s'il n'existe pas
sudo mkdir -p /DOCKER_CONFIG/ObsiGate/data

# Vérifier qu'il existe
ls -la /DOCKER_CONFIG/ObsiGate/

2. Corriger les permissions

Le conteneur s'exécute avec l'utilisateur 1000:1000 (voir docker-compose.yml). Le répertoire doit être accessible en écriture par cet utilisateur.

# Option A: Donner la propriété à l'utilisateur 1000
sudo chown -R 1000:1000 /DOCKER_CONFIG/ObsiGate/data

# Option B: Rendre le répertoire accessible en écriture pour tous (moins sécurisé)
sudo chmod -R 777 /DOCKER_CONFIG/ObsiGate/data

3. Redémarrer le conteneur

cd /path/to/ObsiGate
docker-compose restart

4. Vérifier les logs

Après le redémarrage, les logs backend afficheront des informations détaillées sur la sauvegarde :

docker-compose logs -f obsigate

Recherchez des lignes comme :

• Attempting to save settings to /app/data/vault_settings.json
• Successfully saved settings for X vaults
• Ou des erreurs : Permission denied writing to...

5. Tester la sauvegarde

1. Ouvrez l'interface ObsiGate
2. Allez dans Configuration → Fichiers cachés
3. Modifiez un paramètre (cochez/décochez "Afficher tous les fichiers cachés")
4. Cliquez sur "💾 Sauvegarder"
5. Vous devriez voir un message de succès : "✓ Paramètres sauvegardés"
6. Si erreur, le message affichera maintenant le détail : "Erreur: Permission denied: Cannot write to settings file..."

6. Vérifier que le fichier a été créé

ls -la /DOCKER_CONFIG/ObsiGate/data/vault_settings.json
cat /DOCKER_CONFIG/ObsiGate/data/vault_settings.json

Le fichier devrait contenir un JSON avec vos paramètres :

{
  "Workout": {
    "includeHidden": true,
    "hiddenWhitelist": []
  },
  "Bruno": {
    "includeHidden": false,
    "hiddenWhitelist": [".obsidian"]
  }
}

Vérification des permissions actuelles

# Voir les permissions du répertoire
ls -la /DOCKER_CONFIG/ObsiGate/

# Voir l'utilisateur qui exécute le conteneur
docker-compose exec obsigate id

# Devrait afficher : uid=1000 gid=1000

Alternative : Changer l'utilisateur du conteneur

Si vous ne pouvez pas modifier les permissions de /DOCKER_CONFIG/ObsiGate/data, vous pouvez changer l'utilisateur du conteneur dans docker-compose.yml :

services:
  obsigate:
    # Remplacer user: "1000:1000" par l'UID/GID du propriétaire du répertoire
    user: "0:0"  # root (non recommandé pour la sécurité)
    # OU
    user: "$(id -u):$(id -g)"  # Votre utilisateur actuel

Puis redémarrez :

docker-compose down
docker-compose up -d

Autres problèmes courants

Les fichiers cachés ne s'affichent pas après sauvegarde

Cause : Les paramètres sont sauvegardés mais l'index n'a pas été reconstruit.

Solution : Après avoir cliqué sur "Sauvegarder", cliquez sur "🔄 Réindexer" pour reconstruire l'index avec les nouveaux paramètres.

L'interface se fige lors de la réindexation

Cause : Vous essayez d'indexer un très gros répertoire caché (ex: .git, .node_modules).

Solution :

1. N'activez pas "Afficher tous les fichiers cachés" pour les vaults contenant de gros répertoires cachés
2. Utilisez plutôt la liste blanche pour ajouter uniquement les dossiers cachés spécifiques dont vous avez besoin (ex: .obsidian)
3. La réindexation sélective (uniquement les vaults modifiés) devrait être plus rapide

Message "Permission denied" dans les logs

Voir la section principale ci-dessus pour corriger les permissions.