Skip to content

8. Configuration

Deutsch

8.1 Where the file is

Box or library Config
box of the installer the config of its slot, /srv/tinyjukebox/current/config/tinyjukebox.yaml; it comes with every version
box of the playbook /srv/tinyjukebox/config/tinyjukebox.yaml, written by every run of the playbook
library on the NAS /var/packages/tinyjukebox-library/var/library.yaml
--data DIR (Docker, PC) built in; DIR/config.yaml, if there is one, changes single values

Most of what an admin sets is on the page and needs no file: volume limits (manual, section 10), the library of a box, update mode, backups. A change of the file takes effect after sudo systemctl restart tinyjukebox.

8.2 Keys an admin changes

Key Meaning On the box
logger/log-level how much the log says INFO
tinyjukebox/rest-api/session-timeout logout after this many seconds without a request 604800 (7 days)
tinyjukebox/rest-api/idle-timeout logout after this many seconds in which nothing was done on an open page; 0: never 1800 (30 minutes)
tinyjukebox/rest-api/max-upload-size MB per uploaded MP3 file 500
tinyjukebox/sync/keep-free MB that stay free on the card of a box with a library; when less is free, the albums not played for the longest time go 500
tinyjukebox/backups-folder where a box without a library keeps its backups, until another folder is set on its page backups beside the albums

Every key: configuration.md, sections 4 to 6, and on the documentation site the generated table of all keys (tab "Reference", "Configuration keys"). Unknown keys stop the start: the message names the path of the key.