Votre conteneur démarre, mais vous ne savez pas si la base de données et les données financières survivront à un redémarrage.
Pour déployer un système open source de gestion des finances personnelles avec Sure, vérifiez d’abord la procédure Docker et les variables dans les sources officielles, puis configurez la base de données, créez votre compte et testez une sauvegarde suivie d’une restauration avant la mise en service.
Ce guide s’adresse à vous si vous voulez héberger Sure sur votre propre serveur, gérer des finances personnelles ou familiales et conserver la maîtrise des données. Il convient aussi si vous connaissez déjà Docker, mais souhaitez vérifier la persistance et la récupération avant d’y confier des informations sensibles.
Avant l’installation : les contrôles qui évitent les mauvaises surprises
Commencez par ouvrir la documentation officielle de l’hébergement Docker de Sure, puis comparez-la au fichier Compose fourni par le projet et à son exemple de variables d’environnement. Ces références sont les points de départ pour confirmer la méthode actuellement documentée, les services à démarrer, les variables attendues et les répertoires à conserver.
Ne déduisez pas le moteur de base de données, les noms des variables ou les ports à partir d’un ancien tutoriel. Ces éléments peuvent dépendre de la version et de l’architecture réellement décrites par le projet. Si une valeur n’est pas expliquée dans la documentation ou l’exemple correspondant, considérez-la comme inconnue et vérifiez-la avant de lancer l’application.
Vous pouvez commencer l’installation lorsque vous avez réuni les éléments suivants :
- Un serveur sur lequel Docker et Docker Compose sont installés et fonctionnels.
- Le fichier Compose officiel et les consignes adaptées à la version de Sure que vous souhaitez déployer.
- Un espace de stockage suffisant pour les conteneurs, la base de données et les sauvegardes. Estimez-le à partir de votre usage et surveillez son évolution ; ne prenez pas une exigence minimale non confirmée pour une valeur garantie.
- Un accès réseau permettant d’atteindre l’interface, avec une règle de pare-feu cohérente avec le port réellement défini dans la configuration.
- Des identifiants forts et un emplacement protégé pour les secrets.
- Un emplacement distinct du serveur pour stocker les sauvegardes importantes.
La première décision concerne le type de déploiement. Un fichier d’exemple peut être destiné à être adapté plutôt qu’utilisé tel quel : lisez les commentaires, repérez les valeurs à remplacer et vérifiez que les volumes et les services sont compatibles avec votre environnement.
| Élément à contrôler | Où le vérifier | Décision avant le démarrage |
|---|---|---|
| Image et services requis | Documentation Sure et fichier Compose officiel | Reprendre les valeurs documentées pour la version choisie, sans supposer qu’une image ancienne convient |
| Variables de configuration | Exemple officiel de variables et documentation | Renseigner uniquement les clés reconnues et protéger leurs valeurs |
| Base de données | Documentation et services du fichier Compose | Confirmer le moteur, le nom du service et les paramètres de connexion |
| Données persistantes | Sections de volumes du fichier Compose | Identifier les volumes ou chemins à sauvegarder avant toute mise à jour |
| Accès réseau | Ports et paramètres du fichier Compose | Vérifier le port exposé et limiter l’accès selon votre usage |
Un service de finances personnelles mérite une approche plus stricte qu’un essai jetable. Une base de données accessible depuis l’extérieur, un secret placé dans un dépôt public ou un répertoire de données absent du plan de sauvegarde peuvent transformer une installation fonctionnelle en source de perte ou de fuite. Vérifiez donc ces points avant l’import de vos données réelles.
Attention : un fichier d’environnement n’est pas un coffre-fort. Gardez les secrets hors des dépôts publics, limitez les personnes qui peuvent lire les fichiers de configuration et évitez de copier des identifiants réels dans une commande partagée.
Démarrage de Sure avec Docker
Pour installer Sure, utilisez la procédure de déploiement Docker indiquée par le projet, et non une commande trouvée dans un guide ancien sans vérification. Après avoir récupéré le fichier Compose correspondant aux instructions officielles, examinez les services, les images, les ports, les variables et les volumes. Remplacez les valeurs d’exemple seulement lorsque la documentation explique ce qu’elles doivent contenir.
Dans le répertoire où se trouve votre fichier Compose, vous pouvez d’abord contrôler la configuration puis démarrer les services :
docker compose -f compose.example.yml config
docker compose -f compose.example.yml up -d
Le nom compose.example.yml correspond au fichier d’exemple du projet ; si vous en avez créé une copie adaptée, utilisez son chemin réel. La première commande demande à Compose d’interpréter la configuration. Corrigez les erreurs de syntaxe et les variables non résolues avant de poursuivre. La seconde démarre les services en arrière-plan. La référence officielle de Docker Compose décrit ces commandes et leurs options.
Contrôlez ensuite l’état des services et les journaux :
docker compose -f compose.example.yml ps
docker compose -f compose.example.yml logs
Une liste de conteneurs ne suffit pas à prouver que l’application est prête. Repérez les services qui redémarrent, les erreurs de connexion à la base de données et les messages de configuration manquante. Si les journaux sont longs, consultez ceux du service concerné en utilisant son nom tel qu’il apparaît dans le fichier Compose. N’inventez pas un nom de service à partir d’un autre exemple.
Ouvrez l’adresse correspondant au port effectivement configuré. Vérifiez que la page de Sure s’affiche et que vous pouvez atteindre le parcours d’initialisation ou de connexion documenté. Si le navigateur ne répond pas, contrôlez d’abord le port publié, le pare-feu et les journaux ; ne modifiez pas plusieurs paramètres à la fois, car vous perdriez la trace de la cause.
Configuration de la base de données et persistance
La configuration de la base de données doit refléter le déploiement officiel que vous avez retenu. Consultez le fichier des variables d’environnement de Sure pour repérer les paramètres effectivement prévus, puis vérifiez leur rôle dans la documentation ou le fichier Compose. Ne créez pas de variables en vous fiant à leur nom supposé et ne réutilisez pas automatiquement les valeurs d’un autre projet.
Selon l’architecture documentée, la configuration peut réunir l’adresse ou le nom du service de base de données, le port, le nom de la base, l’utilisateur et son secret. Ce sont des exemples de catégories à vérifier, pas une liste de paramètres garantis par Sure. Conservez les valeurs dans le mécanisme prévu par le déploiement et évitez de les afficher dans des captures d’écran, des journaux copiés dans un ticket ou un fichier public.
La persistance se vérifie dans la définition des volumes. La documentation Docker sur les volumes explique que ceux-ci permettent de conserver des données indépendamment du cycle de vie d’un conteneur. Pour Sure, identifiez précisément les volumes ou chemins montés par le fichier Compose officiel : ne supposez pas que toutes les données sont stockées dans un seul volume, ni qu’un volume anonyme est automatiquement couvert par votre sauvegarde.
Une fois les services démarrés, suivez cette vérification progressive :
- Confirmez dans les journaux que l’application atteint la base de données sans erreur d’authentification ni délai de connexion.
- Connectez-vous à l’interface et réalisez une opération de test non sensible, si le fonctionnement documenté le permet.
- Vérifiez que l’opération reste visible après actualisation de la page et nouvelle connexion.
- Redémarrez les services avec la commande prévue par Compose, puis contrôlez à nouveau la lecture des données.
- Vérifiez dans la configuration que les données sont bien associées aux volumes ou chemins identifiés pour la sauvegarde.
Si Sure ne peut pas se connecter, comparez les paramètres de connexion entre les services, vérifiez que le nom d’hôte correspond au nom du service réellement défini et consultez les journaux des deux côtés. Une erreur de résolution du nom, un identifiant incorrect et une base non prête peuvent produire des symptômes proches, mais ne se corrigent pas de la même façon. Modifiez un paramètre à la fois, puis relancez la vérification.
Création des comptes et protection des accès
Après le démarrage, suivez le parcours de création de compte ou d’initialisation décrit par Sure. La disponibilité d’un parcours, les possibilités de création d’autres comptes et les niveaux d’autorisation doivent être confirmés dans la documentation de la version déployée. Ne supposez pas l’existence de rôles, d’invitations ou de fonctions de gestion d’équipe sans indication officielle.
Pour vérifier votre accès, créez le compte initial selon le parcours présenté, connectez-vous, puis confirmez que l’interface charge les données attendues. Si le système propose des réglages de compte, relevez ce qui est effectivement disponible dans votre version et gardez une trace de la procédure de récupération autorisée. Ne confondez pas compte applicatif et identifiants de base de données : ils servent à des usages différents et ne doivent pas être interchangeables.
Choisissez un secret unique et difficile à deviner, et conservez-le dans un gestionnaire adapté. Pour les secrets de la base, limitez l’accès aux fichiers qui les contiennent et vérifiez leurs permissions sur le serveur. Si plusieurs personnes administrent l’hôte, définissez qui peut consulter ou modifier ces fichiers et qui est autorisé à restaurer une sauvegarde. Ces décisions évitent qu’un simple dépannage implique de divulguer des identifiants à des personnes qui n’en ont pas besoin.
Sauvegarde et restauration des données financières
Une sauvegarde exploitable doit couvrir les éléments nécessaires à la reconstruction du service, pas seulement le conteneur applicatif. Partez du fichier Compose et de la documentation Sure pour dresser la liste des données persistantes : base de données, éventuels répertoires de fichiers et configuration indispensable au redémarrage. La liste exacte dépend de l’installation que vous avez mise en place.
Si la documentation de votre déploiement confirme que Sure utilise PostgreSQL, l’outil pg_dump peut servir à exporter la base. La documentation officielle précise que pg_dump exporte une base de données par exécution et propose quatre formats de sortie : texte brut, format personnalisé, répertoire et tar. Elle indique également que les formats personnalisé et répertoire permettent de sélectionner les éléments lors d’une restauration. Consultez la documentation de pg_dump et choisissez le format selon votre procédure de récupération.
Exemple à adapter uniquement si PostgreSQL est bien le moteur documenté et si les noms correspondent à votre configuration :
pg_dump --format=custom --file=sure-backup.dump \
--host=<hote_base> --username=<utilisateur> <nom_base>
Remplacez chaque valeur entre chevrons par celle de votre déploiement et choisissez un emplacement protégé. Ne placez pas un vrai mot de passe dans l’historique du terminal ou dans un script partagé. Si l’outil n’est pas installé sur l’hôte, consultez la documentation de votre installation pour exécuter la sauvegarde depuis l’environnement approprié ; ne supposez pas que le conteneur applicatif contient les outils d’administration de la base.
Une copie conservée uniquement sur le même serveur ne protège pas contre la panne de ce serveur, un effacement accidentel ou une erreur de manipulation. Stockez les sauvegardes dans un emplacement séparé, limitez l’accès et vérifiez régulièrement qu’elles peuvent être lues. Sauvegardez aussi les éléments de configuration nécessaires, en protégeant les secrets ; une copie de configuration ne doit pas devenir un moyen de les exposer.
Une sauvegarde n’est validée qu’après une restauration réussie. Effectuez l’essai dans un environnement isolé, afin de ne pas écraser les données de production ni de rendre une instance de test accessible à des tiers.
Pour tester la récupération, préparez une instance isolée avec une configuration compatible, restaurez la base selon la méthode correspondant au format choisi, puis remettez en place les autres données persistantes requises. Vérifiez que le service démarre, que le compte attendu peut se connecter et que les enregistrements de test restent lisibles. Si vous utilisez des données financières réelles pour l’essai, protégez l’environnement de restauration avec les mêmes précautions d’accès que le service principal.
Réception de l’installation et diagnostic
Votre installation n’est pas prête parce que la page d’accueil s’affiche. Avant d’importer ou de saisir des informations financières réelles, parcourez la liste suivante et cochez chaque point que vous avez vérifié :
- [ ] Le fichier Compose utilisé correspond aux instructions officielles de la version retenue.
- [ ] Les variables réellement requises sont identifiées et les secrets ne sont pas exposés publiquement.
- [ ] Les conteneurs sont actifs et leurs journaux ne montrent pas d’échec récurrent.
- [ ] L’interface Sure est accessible depuis le réseau prévu, sans exposition inutile de la base de données.
- [ ] Une opération de test est enregistrée et reste lisible après redémarrage.
- [ ] Les volumes ou chemins contenant les données ont été identifiés et inclus dans la stratégie de sauvegarde.
- [ ] Une sauvegarde a été restaurée dans un environnement isolé et les données attendues y sont accessibles.
- [ ] La procédure d’accès, les emplacements de sauvegarde et les paramètres réels ont été consignés dans un espace protégé.
Pour un échec au démarrage, comparez le message d’erreur aux variables et chemins du fichier Compose, puis vérifiez que l’image demandée et la méthode d’installation correspondent à la documentation actuelle. Pour une erreur de base de données, examinez l’adresse, les identifiants, le nom de base et l’état du service, sans publier les valeurs secrètes dans vos échanges de dépannage. Pour des données qui disparaissent après redémarrage, recherchez un volume absent, un chemin monté différent ou un emplacement de données non inclus dans la sauvegarde.
Conservez une fiche d’exploitation avec les versions réellement installées, le fichier Compose adapté, les variables requises sans y inscrire les secrets en clair, les chemins persistants et la procédure de restauration. Répétez le test de récupération après une modification importante de l’architecture ou de la configuration. Cette discipline est particulièrement utile si vous gérez seul les finances du foyer : elle évite de découvrir, au moment d’un incident, que l’export existe mais que personne ne sait le restaurer.
Si Sure est validé sur votre serveur, gardez cette installation séparée de vos besoins de développement ou de création. Un poste local peut convenir à un usage quotidien, tandis qu’un environnement distant peut être pertinent pour un travail macOS ponctuel, un test de construction ou un projet audio et vidéo qui dépend de ce système. Pour évaluer ce second besoin, consultez le guide d’utilisation d’un Mac à distance ; avant de choisir un environnement hébergé, vérifiez également les conditions d’utilisation applicables, notamment celles qui encadrent l’accès et la gestion des données. Ces solutions ne remplacent pas une sauvegarde de Sure : retenez-les uniquement si votre travail exige réellement un environnement macOS, et revenez à la liste de réception pour contrôler la disponibilité, la persistance et la restauration de vos données financières.
