maloja/settings.md

Technically, each setting can be set via environment variable or the settings file - simply add the prefix MALOJA_ for environment variables. The columns are filled according to what is reasonable, it is recommended to use the settings file where possible and not configure each aspect of your server via environment variables!

Settings File	Environment Variable	Type	Description
Setup
data_directory	MALOJA_DATA_DIRECTORY	String	Folder for all user data. Overwrites all choices for specific directories.
directory_config	MALOJA_DIRECTORY_CONFIG	String	Folder for config data. Only applied when global data directory is not set.
directory_state	MALOJA_DIRECTORY_STATE	String	Folder for state data. Only applied when global data directory is not set.
directory_logs	MALOJA_DIRECTORY_LOGS	String	Folder for log data. Only applied when global data directory is not set.
directory_cache	MALOJA_DIRECTORY_CACHE	String	Folder for cache data. Only applied when global data directory is not set.
skip_setup	MALOJA_SKIP_SETUP	Boolean	Make server setup process non-interactive. Vital for Docker.
force_password	MALOJA_FORCE_PASSWORD	String	On startup, overwrite admin password with this one. This should usually only be done via environment variable in Docker.
clean_output	MALOJA_CLEAN_OUTPUT	Boolean	Use if console output will be redirected e.g. to a web interface.
Debug
logging	MALOJA_LOGGING	Boolean	Enable Logging
dev_mode	MALOJA_DEV_MODE	Boolean	Enable developer mode
Network
host	MALOJA_HOST	String	Host for your server - most likely :: for IPv6 or 0.0.0.0 for IPv4
port	MALOJA_PORT	Integer	Port
Technical
cache_expire_positive	MALOJA_CACHE_EXPIRE_POSITIVE	Integer	Days until images are refetched
cache_expire_negative	MALOJA_CACHE_EXPIRE_NEGATIVE	Integer	Days until failed image fetches are reattempted
use_db_cache	MALOJA_USE_DB_CACHE	Boolean	Use DB Cache
cache_database_short	MALOJA_CACHE_DATABASE_SHORT	Boolean	Use volatile Database Cache
cache_database_perm	MALOJA_CACHE_DATABASE_PERM	Boolean	Use permanent Database Cache
db_cache_entries	MALOJA_DB_CACHE_ENTRIES	Integer	Maximal Cache entries
db_max_memory	MALOJA_DB_MAX_MEMORY	Integer	Maximal percentage of RAM that should be used by whole system before Maloja discards cache entries. Use a higher number if your Maloja runs on a dedicated instance (e.g. a container)
Fluff
scrobbles_gold	MALOJA_SCROBBLES_GOLD	Integer	How many scrobbles a track needs to be considered 'Gold' status
scrobbles_platinum	MALOJA_SCROBBLES_PLATINUM	Integer	How many scrobbles a track needs to be considered 'Platinum' status
scrobbles_diamond	MALOJA_SCROBBLES_DIAMOND	Integer	How many scrobbles a track needs to be considered 'Diamond' status
name	MALOJA_NAME	String	Name
Third Party Services
metadata_providers	MALOJA_METADATA_PROVIDERS	List	Which metadata providers should be used in what order. Musicbrainz is rate-limited and should not be used first.
scrobble_lastfm	MALOJA_SCROBBLE_LASTFM	Boolean	Proxy-Scrobble to Last.fm
lastfm_api_key	MALOJA_LASTFM_API_KEY	String	Last.fm API Key
lastfm_api_secret	MALOJA_LASTFM_API_SECRET	String	Last.fm API Secret
spotify_api_id	MALOJA_SPOTIFY_API_ID	String	Spotify API ID
spotify_api_secret	MALOJA_SPOTIFY_API_SECRET	String	Spotify API Secret
audiodb_api_key	MALOJA_AUDIODB_API_KEY	String	TheAudioDB API Key
track_search_provider	MALOJA_TRACK_SEARCH_PROVIDER	String	Track Search Provider
send_stats	MALOJA_SEND_STATS	Boolean	Send Statistics
Database
invalid_artists	MALOJA_INVALID_ARTISTS	Set	Artists that should be discarded immediately
remove_from_title	MALOJA_REMOVE_FROM_TITLE	Set	Phrases that should be removed from song titles
delimiters_feat	MALOJA_DELIMITERS_FEAT	Set	Delimiters used for extra artists, even when in the title field
delimiters_informal	MALOJA_DELIMITERS_INFORMAL	Set	Delimiters in informal artist strings with spaces expected around them
delimiters_formal	MALOJA_DELIMITERS_FORMAL	Set	Delimiters used to tag multiple artists when only one tag field is available
Web Interface
default_range_charts_artists	MALOJA_DEFAULT_RANGE_CHARTS_ARTISTS	Choice	Default Range Artist Charts
default_range_charts_tracks	MALOJA_DEFAULT_RANGE_CHARTS_TRACKS	Choice	Default Range Track Charts
default_step_pulse	MALOJA_DEFAULT_STEP_PULSE	Choice	Default Pulse Step
charts_display_tiles	MALOJA_CHARTS_DISPLAY_TILES	Boolean	Display Chart Tiles
discourage_cpu_heavy_stats	MALOJA_DISCOURAGE_CPU_HEAVY_STATS	Boolean	Prevent visitors from mindlessly clicking on CPU-heavy options. Does not actually disable them for malicious actors!
use_local_images	MALOJA_USE_LOCAL_IMAGES	Boolean	Use Local Images
local_image_rotate	MALOJA_LOCAL_IMAGE_ROTATE	Integer	Local Image Rotate
timezone	MALOJA_TIMEZONE	Integer	UTC Offset
time_format	MALOJA_TIME_FORMAT	String	Time Format