Configuration

All ShopiTerm services can be configured through environment variables. This page lists all available configuration options per service.

Catalogue

Variable	Description	Default
`LISTEN`	Address on which to listen on	`localhost:3000`
`DB`	Address of PostgreSQL instance	`postgres:///shopiterm_catalogue?host=/var/run/postgresql`
`WAREHOUSE`	Address of the warehouse service	`http://localhost:3002`
`NATS`	Address of the NATS server	`localhost:4222`

Warehouse

Variable	Description	Default
`LISTEN`	Address on which to listen on	`localhost:3000`
`DB`	Address of PostgreSQL instance	`postgres:///shopiterm_warehouse?host=/var/run/postgresql`
`CATALOGUE`	Address of the catalogue service	`http://localhost:3001`

Orders

Variable	Description	Default
`LISTEN`	Address on which to listen on	`localhost:3000`
`DB`	Address of PostgreSQL instance	`postgres:///shopiterm_orders?host=/var/run/postgresql`
`NATS`	Address of NATS instance	`localhost:4222`
`WAREHOUSE`	Address of warehouse service	`http://localhost:3002`
`CATALOGUE`	Address of catalogue service	`http://localhost:3001`

Notificator

Variable	Description	Default
`NATS`	Address of the NATS server	`localhost:4222`
`MAILER_HOST`	Address of the mailer	`localhost`
`MAILER_PORT`	Port of the mailer	`1025`
`ORDER`	Address of order service	`http://localhost:3003`

Payment

Variable	Description	Default
`TALER_BACKEND`	Address of the Taler merchant backend	`https://backend.demo.taler.net`
`TALER_INSTANCE`	Instance on the Taler merchant backend to use	`sandbox`
`TALER_TOKEN`	Bearer token to use for Taler authorization	`secret-token:sandbox`
`NATS`	Address of the NATS server	`nats://localhost:4222`

Recommendations

Variable	Description	Default
`LISTEN`	Address to bind the HTTP listener on	`localhost:3003`
`DATABASE_URL`	PostgreSQL connection URL	required
`CATALOGUE_URL`	Base URL of the catalogue service	`http://localhost:3001`
`NATS_URL`	NATS server URL for the JetStream product-events stream	`nats://localhost:4222`
`RECOMPUTE_INTERVAL_SECS`	Interval in seconds between background recomputation passes (0 disables)	`300`
`WEIGHT_VIEW`	Score weight for a "view" interaction	`1.0`
`WEIGHT_ADD_TO_CART`	Score weight for an "add_to_cart" interaction	`4.0`
`WEIGHT_PURCHASE`	Score weight for a "purchase" interaction	`10.0`
`PERSONALIZED_WINDOW_DAYS`	Window in days of recent interactions used as seed signal for personalized recommendations	`30`

SSH Server

Variable	Description	Default
`LISTEN`	Address on which to listen for SSH connections	`0.0.0.0:2222`
`GATEWAY_URL`	Base URL of the gateway API	`http://localhost:8080`
`HOST_KEY_FILE`	Path to an OpenSSH private key file for the host key	optional
`HOST_KEY`	PEM string for the host key (alternative to HOST_KEY_FILE)	optional
`DB`	PostgreSQL connection URL	`postgres:///shopiterm_ssh?host=/var/run/postgresql`
`JWT_SECRET`	JWT secret for authentication	`YS1zdHJpbmctc2VjcmV0LWF0LWxlYXN0LTI1Ni1iaXRzLWxvbmc`