Skip to main content

Server & runtime

General settings for the Norish server process. Most have sensible defaults; MASTER_KEY is the one you must set.

Core

VariableDescriptionDefault
MASTER_KEY32+ character key for encryption derivation(required)
AUTH_URLPublic URL used for auth callbacks and linkshttp://localhost:3000
NODE_ENVRuntime environmentproduction (set by the Docker image)
HOSTServer bind address0.0.0.0
PORTServer port3000
REDIS_URLRedis connection URL for events and jobsredis://localhost:6379
Generate a MASTER_KEY

MASTER_KEY derives the encryption keys used to protect stored secrets. Generate a strong one and keep it stable — changing it invalidates previously encrypted data:

openssl rand -base64 32

Networking & origins

VariableDescriptionDefault
TRUSTED_ORIGINSComma-separated additional trusted origins(empty)

TRUSTED_ORIGINS is useful when Norish is reached from more than one origin, for example http://192.168.1.100:3000,https://norish.example.com.

Registration

VariableDescriptionDefault
ENABLE_REGISTRATIONAllow new-user registrationfalse

After the first user signs in, registration is disabled automatically. See Authentication.

Logging

VariableDescriptionDefault
NEXT_PUBLIC_LOG_LEVELLog verbosity (debug, info, warn, error)info

Uploads

VariableDescriptionDefault
UPLOADS_DIRUpload storage directory./.runtime/uploads (dev), /app/uploads (prod)
MAX_AVATAR_FILE_SIZEMax avatar upload size (bytes)5242880
MAX_IMAGE_FILE_SIZEMax image upload size (bytes)10485760
MAX_VIDEO_FILE_SIZEMax video upload size (bytes)104857600

Scheduler

VariableDescriptionDefault
SCHEDULER_CLEANUP_MONTHSCleanup retention period in months3