ENV variables

Supported ENV variables

Name	Description
HTML2RSS_SECRET_KEY	required in production; development/test gets a temporary default
HEALTH_CHECK_TOKEN	bearer token for authenticated GET /api/v1/health; optional unless you use that endpoint (the documented Compose stack includes it); /api/v1/health/live and /api/v1/health/ready do not require it
BUILD_TAG	defaults to local in the Compose stack; set release metadata explicitly in production
GIT_SHA	defaults to local in the Compose stack; set deployed commit SHA explicitly in production
SENTRY_DSN	optional; enables Sentry errors/logs when set
BROWSERLESS_IO_WEBSOCKET_URL	optional; Browserless websocket endpoint for browserless strategy
BROWSERLESS_IO_API_TOKEN	required by this site’s Compose stack and by custom websocket endpoints; standalone html2rss local defaults can omit it
AUTO_SOURCE_ENABLED	true by default in development/test, false otherwise
ASYNC_FEED_REFRESH_ENABLED	optional boolean; default false
ASYNC_FEED_REFRESH_STALE_FACTOR	optional integer >= 1; default 3
PORT	app listen port; compose uses 4000
RACK_ENV	Rack environment; compose uses production

Older environment-variable examples from previous docs revisions are obsolete. Use only the supported table above and the Environment & Runtime Flags table in html2rss-web/docs/README.md.