djehooty-backend
djehooty-backend est le composant serveur de Djehooty. Il est responsable de la logique métier, de la gestion des données et de l'exposition d'une API que le frontend et d'autres clients peuvent utiliser pour interagir avec le coeur de Djehooty.
Il est développé en Go et utilise une base de données SQLite. Son code source est disponible sur Codeberg.
Versions
Il existe deux versions de djehooty-backend :
| Versions | Backend | Frontend | Recommandé | |
|---|---|---|---|---|
| djehooty-backend-standalone | ✅ | ✅ | ✅ | |
| djehooty-backend | ✅ |
djehooty-backend-standalone
Application autonome qui intègre à la fois le backend et le frontend.
Elle est conçue pour être utilisée en local sur un ordinateur personnel, sans nécessiter de configuration particulière. Elle est idéale pour tester Djehooty ou pour une utilisation individuelle. C'est l'installation recommandée pour la plupart des utilisateurs.
djehooty-backend-standalone ouvre automatiquement votre navigateur web sur l'adresse http://localhost:3000.
djehooty-backend
Une application serveur qui ne contient que le backend et qui expose uniquement l'API REST, sans client intégré. Elle est conçue pour être déployée sur un serveur ou utilisée pendant le développement. Cette version nécessite un client à part et est destinée à des utilisateurs expérimentés.
Utilisation
Les deux versions se lancent de la même façon :
- Linux
- Windows
- MacOS
djehooty-backend-standalone
./djehooty-standalone-linux-amd64
Votre navigateur web s'ouvre alors automatiquement sur http://localhost:3000.
CTRL+C vous permet de stopper Djehooty.
djehooty-backend
./djehooty-backend-linux-amd64
Aucune interface ne s'ouvre. Un client, séparé, doit se connecter à l'API REST pour interagir avec le serveur.
CTRL+C vous permet de stopper Djehooty.
Ce système d'exploitation n'est pas encore supporté.
Plus d'informations sur le support multiplateforme de Djehooty.
Ce système d'exploitation n'est pas encore supporté.
Plus d'informations sur le support multiplateforme de Djehooty.
Configuration
User Directory
Le dossier User Directory contient la configuration, la base de données et les fichiers utilisateur de Djehooty.
Par défaut, ce dossier est configuré à ~/Djehooty sous Linux.
Lorsqu'il n'existe pas, le dossier User Directory est créé au premier démarrage du serveur.
Contenu du User Directory
| Fichier / Dossier | Description |
|---|---|
| config.yaml | Fichier de configuration de Djehooty |
| djehooty.db | Base de données SQLite de Djehooty |
| files | Dossier contenant tous vos fichiers importés |
| Temp | Dossier temporaire |
| thumbnails | Dossier contenant les vignettes générées à partir de vos fichier |
Changer le User Directory
Il est possible de changer le User Directory par un autre dossier de votre choix, en utilisant l'option --userdir
- Linux
- Windows
- MacOS
./djehooty-backend --userdir ~/Documents/Djehooty
Ce système d'exploitation n'est pas encore supporté.
Plus d'informations sur le support multiplateforme de Djehooty.
Ce système d'exploitation n'est pas encore supporté.
Plus d'informations sur le support multiplateforme de Djehooty.
Fichier de configuration (config.yaml)
djehooty-backend va chercher automatiquement le fichier config.yaml dans User Directory pour charger différents paramètres au démarrage du serveur. Lorsque config.yaml n'existe pas, les paramètres par défaut son chargés automatiquement sans pour autant créer de fichier.
Pour pouvoir modifier les paramètres de djehooty-backend, s'il n'existe pas déjà, créez un fichier config.yaml à la racine du dossier User Directory
Port
Vous pouvez changer le numéro de port, si la valeur part défaut ne vous convient pas
port: 8181
Developpement
Vous pouvez activer le mode développement avec dev_mode.
Puis l'option dev_latency_ms permet d'introduire une latence dans la réponse de tous les endpoints de l'API Rest.
dev_mode: true
dev_latency_ms: 1000