8. Configuration¶
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.