Environment Variables

Playnite Web App

Playnite Web requires configured environment variables. Below are all supported environment variables and their purpose.

Note all environment variables are strings.

Environment Variable	Value	Required?	Example Value	Notes

Environment Variable	Value	Required?	Example Value	Notes
PORT	Defaults to `3000`		3000	Port in which web application is accessible.
HOST	Defaults to `localhost`		`games.mydomain.com`	The domain/host that you will use to access Playnite Web in the browser.
DATABASE_URL		Required	`postgres://${DB_USER}:${DB_PASSWORD}@localhost:5432?schema=public&pgbouncer=true`	Connection string for database. Replace `${DB_USER}` and `${DB_PASSWORD}` with appropriate values.
SECRET		Required	`any randomly generated long string value`	Secret used to protect credentials .
DISABLE_CSP	`true` to disable content security policies; defaults to `false`		`true`	May be useful when accessing via local LAN only. Will negate other options: `CSP_ORIGINS`.
CSP_ORIGINS	Origins in which images, styles, fonts, and scripts are allowed to be loaded.		`images.google.com,gameimages.domain.com`	Multiple values may be provided via a comma-delimited string.
ADDITIONAL_ORIGINS	Additional origins allowed to request graph API.		`mycustomservice.mydomain.com,service2.mydomain.com`	Multiple values may be provided via a comma-delimited string.
MQTT_HOST		Required	`localhost`	Hostname for MQTT broker.
MQTT_PORT	Defaults to `1883`			Port used to access MQTT broker.
MQTT_USERNAME				Used when MQTT broker has been configured to require a username/password.
MQTT_PASSWORD				Used when MQTT broker has been configured to require a username/password.

Environment Variable	Value	Required?	Example Value	Notes

Environment Variable	Value	Required?	Example Value	Notes
PORT	Defaults to `3000`		3000	Port in which web application is accessible.
DATABASE_URL		Required	`postgres://${DB_USER}:${DB_PASSWORD}@localhost:5432?schema=public&pgbouncer=true`	Connection string for database. Replace `${DB_USER}` and `${DB_PASSWORD}` with appropriate values.
MQTT_HOST		Required	`localhost`	Hostname for MQTT broker.
MQTT_PORT	Defaults to `1883`		1883	Port used to access MQTT broker.
MQTT_USERNAME				Used when MQTT broker has been configured to require a username/password.
MQTT_PASSWORD				Used when MQTT broker has been configured to require a username/password.
COVER_ART_PATH		Required	`/opt/playnite-web/game-assets/cover-art`	Path to store downloaded cover art. Should map to a volume.