Configuration
djehooty-backend
User Directory
The User Directory folder contains the configuration, database, and user files for Djehooty.
By default, this folder is set to ~/Djehooty on Linux.
When it doesn't exist, User Directory is created on the first server startup.
Content of the User Directory
| File / Folder | Description |
|---|---|
| config.yaml | Djehooty configuration file |
| djehooty.db | Djehooty SQLite database |
| files | Folder containing all your imported files |
| Temp | Temporary folder |
| thumbnails | Folder containing thumbnails generated from your files |
With the djehooty-backend and djehooty-standalone binaries
You can change this folder using the --userdir option
djehooty-backend --userdir ~/Documents/Djehooty
With Docker
You can change this folder by mounting a different Docker volume to /app/data. Simply replace ../data in your docker-compose.yml with the path of your choice or modify the command line parameters. Make sure to properly set the folder permissions.
With the djehooty-backend Makefile
You can also change this folder by using the DEV_USERDIR environment variable when using the Makefile.
make dev DEV_USERDIR=~/Djehooty-dev2 # Override user directory
make run DEV_USERDIR=~/Djehooty-dev2 # Override user directory
Configuration file
djehooty-backend automatically looks for the config.yaml file in the User Directory to load various parameters on server startup. When config.yaml doesn't exist, default parameters are automatically loaded without creating a file.
To modify djehooty-backend parameters, if it doesn't already exist, create a config.yaml file at the root of the User Directory folder.
Port
You can change the port number if the default value doesn't suit you
port: 8181
Development
You can enable development mode with dev_mode.
Then the dev_latency_ms option allows you to introduce latency in the response of all REST API endpoints.
dev_mode: true
dev_latency_ms: 1000