Skip to main content

General

VariableDefaultDescription
APP_DOMAINBot domain without HTTP/HTTPS and without trailing slash. Used for webhooks.
APP_CRYPT_KEYEncryption key for sensitive data in the database. Must be a valid 44-character Base64 string.
APP_HOST0.0.0.0Address on which the application runs.
APP_PORT5000Application port.
APP_LOCALESruComma-separated list of supported locales. Example: en, ru
APP_DEFAULT_LOCALEruDefault locale.
APP_ORIGINSComma-separated list of allowed CORS origins.

Bot

VariableDefaultDescription
BOT_TOKENTelegram Bot API token. Obtain it from @BotFather.
BOT_SECRET_TOKENSecret token for verifying webhooks from Telegram.
BOT_OWNER_IDTelegram ID of the bot owner. Grants elevated permissions.
BOT_SUPPORT_USERNAMETelegram username of the support account for deep-linking (without @).
BOT_MINI_APPfalseBehavior of the “connect” button: false — browser, true — WebApp, URL — open specified address.
BOT_RESET_WEBHOOKfalseWhether to reset the webhook on startup.
BOT_DROP_PENDING_UPDATESfalseWhether to ignore pending updates on startup.
BOT_SETUP_COMMANDStrueWhether to set up bot commands on startup.
BOT_USE_BANNERStrueWhether to use banners in bot messages.

Remnawave

VariableDefaultDescription
REMNAWAVE_HOSTremnawaveHostname or Docker service name for connecting to the Remnawave API. Without HTTP/HTTPS and without trailing slash.
REMNAWAVE_TOKENRemnawave API token. Created in the panel: Settings → API Tokens.
REMNAWAVE_WEBHOOK_SECRETSecret token for verifying webhooks from Remnawave. Must match WEBHOOK_SECRET_HEADER in the panel’s .env.
REMNAWAVE_CADDY_TOKENToken for authentication via Caddy (optional).
REMNAWAVE_COOKIECookie for requests in key=value format (optional).
REMNAWAVE_CF_CLIENT_IDCloudflare Access Client ID (optional).
REMNAWAVE_CF_CLIENT_SECRETCloudflare Access Client Secret (optional).

Database

VariableDefaultDescription
DATABASE_PASSWORDPassword for connecting to PostgreSQL.
DATABASE_HOSTremnashop-dbDatabase host.
DATABASE_PORT5432Database port.
DATABASE_NAMEremnashopDatabase name.
DATABASE_USERremnashopDatabase user.
DATABASE_POOL_SIZE30Connection pool size.
DATABASE_MAX_OVERFLOW30Maximum additional connections beyond the pool.
DATABASE_POOL_TIMEOUT10Timeout for waiting for a connection from the pool (sec).
DATABASE_POOL_RECYCLE3600Connection lifetime in the pool (sec).
DATABASE_ECHOfalseLog SQL queries.
DATABASE_ECHO_POOLfalseLog connection pool events.

Redis

VariableDefaultDescription
REDIS_HOSTremnashop-redisRedis host.
REDIS_PORT6379Redis port.
REDIS_NAME0Redis database number.
REDIS_PASSWORDRedis password (optional).

Logging

VariableDefaultDescription
LOG_TO_FILEtrueWrite logs to file.
LOG_LEVELDEBUGLog level: DEBUG, INFO, WARNING, ERROR, CRITICAL.
LOG_ROTATION100MBLog file rotation condition. Example: 100MB or 00:00.
LOG_COMPRESSIONzipCompression format for archived logs.
LOG_RETENTION3 daysRetention period for archived logs.