maloja/settings.md

Technically, each setting can be set via environment variable or the settings file. The columns are filled according to what is reasonable. Please do not configure each aspect of your server via environment variables!

Settings File	Environment Variable	Type	Description
Setup
	MALOJA_DATA_DIRECTORY	String	Use this directory to store all application files. Useful for docker. Overwrites all individually specified directories below.
	MALOJA_DIRECTORY_CONFIG	String	Use this directory to store configuration files.
DIRECTORY_STATE	MALOJA_DIRECTORY_STATE	String	Use this directory to store state files.
DIRECTORY_LOGS	MALOJA_DIRECTORY_LOGS	String	Use this directory to store log files.
DIRECTORY_CACHE	MALOJA_DIRECTORY_CACHE	String	Use this directory to store cache files.
SKIP_SETUP	MALOJA_SKIP_SETUP	Boolean	Whether to make server startup non-interactive. Vital for docker.
	MALOJA_FORCE_PASSWORD	String	Sets password for admin login in web interface. This should normally be done via the interactive prompt.
CLEAN_OUTPUT	MALOJA_CLEAN_OUTPUT	Boolean	Avoid mutable console output. 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
Technical
WEB_PORT		Integer	HTTP port to use for your web interface and API
HOST		String	Host for your server - most likely :: for IPv6 or 0.0.0.0 for IPv4
CACHE_EXPIRE_POSITIVE		Integer	Days until images are refetched
CACHE_EXPIRE_NEGATIVE		Integer	Days until failed image fetches are reattempted
USE_DB_CACHE		Boolean	Whether to use the Database Cache.
CACHE_DATABASE_SHORT		Boolean	Whether to use the Volatile DB Cache.
CACHE_DATABASE_PERM		Boolean	Whether to use the Permanent DB Cache.
DB_CACHE_ENTRIES		Integer	Maximal entries of cache.
DB_MAX_MEMORY		Integer	Maximal percentage of total 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		Integer	How many scrobbles should be considered 'Gold' status for a track
SCROBBLES_PLATINUM		Integer	How many scrobbles should be considered 'Platinum' status for a track
SCROBBLES_DIAMOND		Integer	How many scrobbles should be considered 'Diamond' status for a track
NAME		String	Your Name for display
Third Party Services
METADATA_PROVIDERS		List (String)	Which metadata providers should be used in what order. Musicbrainz is rate-limited and should not be used first.
SCROBBLE_LASTFM		Boolean	Proxy-scrobble to Last.fm
LASTFM_API_KEY		String	API key for Last.fm. Necessary if proxy-scrobbling to Last.fm or using it as a metadata provider
LASTFM_API_SECRET		String	API secret for Last.fm. Necessary if proxy-scrobbling to Last.fm or using it as a metadata provider
SPOTIFY_API_ID		String	API ID for Spotify. Necessary if using it as a metadata provider.
SPOTIFY_API_SECRET		String	API Secret for Spotify. Necessary if using it as a metadata provider.
TRACK_SEARCH_PROVIDER		String	Provider for track search next to scrobbles. None to disable.
THUMBOR_SERVER		String	URL of Thumbor server to serve custom artwork.
THUMBOR_SECRET		String	Secret of Thumbor server
Database
INVALID_ARTISTS		List (String)	Artists that should be discarded immediately
REMOVE_FROM_TITLE		List (String)	Phrases that should be removed from song titles
Web Interface
DEFAULT_RANGE_CHARTS_ARTISTS		String	What range is shown per default for the tile view on the start page
DEFAULT_RANGE_CHARTS_TRACKS		String	What range is shown per default for the tile view on the start page
DEFAULT_STEP_PULSE		String	What steps are shown per default for the pulse view on the start page
CHARTS_DISPLAY_TILES		Boolean	Whether to show tiles on chart pages
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		Boolean	Use local images if present
LOCAL_IMAGE_ROTATE		Integer	How many seconds to wait between rotating local images