Skip to main content

Backend Options Reference

Configuration Usage

Backend options can be configured either through:

  1. Environment Variables: Use the exact ENV_VAR name listed below in your .env file or container environment.
  2. Configuration File (app-config.service.json): Use the exact option.name as JSON keys.

Showing 169 of 169 options
Option NameEnvironment VariableTypeDefaultDescription
environment
Environment
NODE_ENV
stringproduction
Specifies the application environment. Possible values are 'development', 'production'
system.super-admin.username
Super Admin Username
SYSTEM_SUPER_ADMIN_USERNAME
string
Username of the super admin user.
system.super-admin.password
Super Admin Password
SYSTEM_SUPER_ADMIN_PASSWORD
string
Password of the super admin user.
system.super-admin.first-name
Super Admin First Name
SYSTEM_SUPER_ADMIN_FIRST_NAME
string
First name of the super admin user.
system.super-admin.last-name
Super Admin Last Name
SYSTEM_SUPER_ADMIN_LAST_NAME
string
Last name of the super admin user.
system.super-admin.email
Super Admin Email
SYSTEM_SUPER_ADMIN_EMAIL
string
Email of the super admin user.
system.default-client.id
Default Client ID
SYSTEM_DEFAULT_CLIENT_ID
string
Client ID of the default client.
system.default-client.secret
Default Client Secret
SYSTEM_DEFAULT_CLIENT_SECRET
string
Client secret of the default client.
system.default-client.display-name
Default Client Display Name
SYSTEM_DEFAULT_CLIENT_DISPLAY_NAME
string
Display name of the default client.
system.default-client.redirect-uris
Default Client Redirect URIs
SYSTEM_DEFAULT_CLIENT_REDIRECT_URIS
stringArray["http://localhost:2000","http://localhost:2001"]
Redirect URIs of the default client.
system.app-host
Application Host
SYSTEM_APP_HOST
stringhttp://localhost:2000
Hostname of Liquid
system.enable-swagger
Enable Swagger
SYSTEM_ENABLE_SWAGGER
booleanfalse
Specifies if swagger UI is available. If enabled, swagger will be available on /docs
system.reverse-proxy-mode
Reverse Proxy Mode
SYSTEM_REVERSE_PROXY_MODE
booleanfalse
Specifies if Liquid is sitting behind a reverse proxy like nginx.
system.log-level
Log Level
SYSTEM_LOG_LEVEL
stringdebug
Log level for the application. Possible values are debug, info, warn, error
system.log-file-path
Log File Path
SYSTEM_LOG_FILE_PATH
string
The log file path.
system.app-port
Application Port
SYSTEM_APP_PORT
number2000
Port to listen on.
system.app-name
Application Name
SYSTEM_APP_NAME
stringLiquid
Name of the application.
system.stats.enable-request-counting
Stats Enable Request Counting
SYSTEM_STATS_ENABLE_REQUEST_COUNTING
booleanfalse
Specifies if application should count the number of requests served since service was started and return it in stats API.
system.stats.request-counter-key
Stats Request Counter Key
SYSTEM_STATS_REQUEST_COUNTER_KEY
stringliquid-request-count
Specifies the key to be used for storing and retrieving request count in express app.
system.request-body.json.max-size
System Request Body Max Size (JSON)
SYSTEM_REQUEST_BODY_JSON_MAX_SIZE
string1mb
Specifies maximum size limit for request body for JSON requests.
system.use-built-in-static-ui
Use Built-In Static UI
SYSTEM_USE_BUILT_IN_STATIC UI
booleantrue
Specifies if Liquid can use it's built-in static UI. Turn this off if you are building your own login and signup pages.
system.static.app-config-file-path
Static App Config File Path
SYSTEM_STATIC_APP_CONFIG_FILE_PATH
string
Specifies the file path for frontend configuration file. Defaults to the contents of https://github.com/shrihari-prakash/liquid/blob/main/src/public/configuration/app-config.sample.json.
system.service.app-config-file-path
Service App Config File Path
SYSTEM_SERVICE_APP_CONFIG_FILE_PATH
string
Specifies the file path for backend configuration file.
system.scope-extension-file-path
Scope Extension File Path
SYSTEM_SCOPE_EXTENSION_FILE_PATH
string/var/liquid/scope-extensions.json
Specifies the path of the JSON file that contains array of scopes that need to be added to liquid in addition to the default ones.
system.enable-response-compression
Enable Response Compression
SYSTEM_ENABLE_RESPONSE_COMPRESSION
booleanfalse
Specifies if liquid can GZip HTTP responses.
system.iframe.action
Iframe Action
SYSTEM_IFRAME_ACTION
stringSAMEORIGIN
Specifies the action to be taken when the application is loaded in an iframe. Possible values are `DENY`, `ALLOW`, `SAMEORIGIN`
system.roles.scan-interval
Roles Scan Interval
SYSTEM_ROLES_SCAN_INTERVAL
number300
Specifies the interval in seconds to scan for new roles.
cookie.session-secret
Cookie Session Secret
COOKIE_SESSION_SECRET
string00000000-0000-0000-0000-000000000000
A random 64+ bit string to use as the session secret.
cookie.domain
Cookie Domain
COOKIE_DOMAIN
string
Specifies the cookie domain for session cookies.
cookie.max-age
Cookie Max Age
COOKIE_MAX_AGE
number
Specifies in seconds the expiry time for session cookies.
cookie.secure
Cookie Secure
COOKIE_SECURE
booleantrue
Specifies if cookies sshould be secure.
mongo-db.connection-string
MongoDB Connection String
MONGO_DB_CONNECTION_STRING
stringmongodb://127.0.0.1:27017/accounts
Connection string to connect to MongoDB.
mongo-db.use-transactions
MongoDB Use Transactions
MONGO_DB_USE_TRANSACTIONS
booleanfalse
Specifies if application can use MongoDB transactions in APIs where multiple write operations are involved. Highly recommended that you turn this on if you have a replica set.
oauth.authorization-code-lifetime
Authorization Code Lifetime
OAUTH_AUTHORIZATION_CODE_LIFETIME
number300
Expiry time in seconds for authorization codes.
oauth.access-token-lifetime
Access Token Lifetime
OAUTH_ACCESS_TOKEN_LIFETIME
number3600
Expiry time in seconds for access tokens.
oauth.refresh-token-lifetime
Refresh Token Lifetime
OAUTH_REFRESH_TOKEN_LIFETIME
number1209600
Expiry time in seconds for refresh tokens.
oauth.authorization.enable-redirect
OAuth Authorization Enable Redirect
OAUTH_AUTHORIZATION_ENABLE_REDIRECT
booleantrue
Specifies if the application should redirect to the specified URL upon successful authorization. If set to false, authorization code will be sent as a JSON response.
oauth.authorization.require-pkce
OAuth Authorization Require PKCE
OAUTH_AUTHORIZATION_REQUIRE_PKCE
booleanfalse
Specifies if the application should require PKCE for authorization.
system.default-client.is-public
System Default Client Is Public
SYSTEM_DEFAULT_CLIENT_IS_PUBLIC
booleantrue
Specifies if the bootstrapped default client is a public client (e.g., SPAs/Mobile apps). Default is true.
system.email-adapter
System Email Adapter
SYSTEM_EMAIL_ADAPTER
stringsendgrid
Specifies the adapter to use to send emails to users. Possible values are `nodemailer`, `sendgrid`, `ses`, `pusher`, `webhook`, `print`
nodemailer.service-name
Nodemailer Service Name
NODEMAILER_SERVICE_NAME
string
Service name for nodemailer.
nodemailer.host
Nodemailer Host
NODEMAILER_HOST
string
Host for nodemailer.
nodemailer.port
Nodemailer Port
NODEMAILER_PORT
string
Port for nodemailer.
nodemailer.secure
Nodemailer Secure
NODEMAILER_SECURE
boolean
Specifies if nodemailer should be secure.
nodemailer.username
Nodemailer Username
NODEMAILER_USERNAME
string
Username for nodemailer.
nodemailer.password
Nodemailer Password
NODEMAILER_PASSWORD
string
Password for nodemailer.
nodemailer.ciphers
Nodemailer Ciphers
NODEMAILER_CIPHERS
stringSSLv3
Ciphers for nodemailer.
nodemailer.reject-unauthorized
Nodemailer Reject Unauthorized
NODEMAILER_REJECT_UNAUTHORIZED
booleanfalse
Specifies if nodemailer should reject unauthorized.
sendgrid.api-key
Sendgrid API Key
SENDGRID_API_KEY
string
API key for sendgrid.
sendgrid.verification-email-template-id
Sendgrid Verification Email Template ID
SENDGRID_VERIFICATION_EMAIL_TEMPLATE_ID
string
Specifies the template ID of verification email template. Leave blank if you want to use plain text. Variables that will be replaced on template: `app_name`, `person_id`, `person_name`, `verification_code`
aws.ses.region
AWS SES Region
AWS_SES_REGION
string
AWS region for SES client.
aws.ses.access-key-id
AWS SES Access Key ID
AWS_SES_ACCESS_KEY_ID
string
AWS access key ID for SES client.
aws.ses.access-key-secret
AWS SES Access Key Secret
AWS_SES_ACCESS_KEY_SECRET
string
AWS access key secret for SES client.
email.outbound-address
Email Outbound Address
EMAIL_OUTBOUND_ADDRESS
stringliquid@example.com
Email address to be used for outgoing emails from the system. This option is preferred over `sendgrid.outbound-email-address`
webhook.url
Webhook URL
WEBHOOK_URL
string
Webhook URL for the webhook email adapter. An HTTP POST request will be made to this URL with the email object.
webhook.secret
Webhook Secret
WEBHOOK_SECRET
string
Secret key for generating the HMAC SHA256 signature for the webhook payload. Will be sent via the X-Webhook-Signature header.
webhook.timeout
Webhook Timeout
WEBHOOK_TIMEOUT
number5000
Timeout in milliseconds for the webhook POST requests.
email.verification-template
Verification Email Template File Path
EMAIL_VERIFICATION_TEMPLATE
string
Specifies the absolute path for the HTML template to be used for sending verification emails. Variables to be included in the template: `%app_name%`, `%person_id%`, `%person_name%`, `%verification_code%`. Ignore if you are using a Sendgrid template or the default verification template.
storage.cloud-path
Storage Cloud Path
STORAGE_Cloud_PATH
stringcontent
Path to store user uploaded files.
s3.endpoint
S3 Endpoint
S3_ENDPOINT
string
Endpoint to be used for S3 storage.
s3.access-key-id
S3 Access Key ID
S3_ACCESS_KEY_ID
string
Access key ID to be used for S3 storage.
s3.access-key-secret
S3 Access Key Secret
S3_ACCESS_KEY_SECRET
string
Access key secret to be used for S3 storage.
s3.bucket-name
S3 Bucket Name
S3_BUCKET_NAME
stringliquid
Bucket name to be used for S3 storage.
s3.get-object-expiry
S3 Get Object Expiry
S3_GET_OBJECT_EXPIRY
number3600
Expiry for getObject pre signed URLs.
s3.put-object-expiry
S3 Put Object Expiry
S3_PUT_OBJECT_EXPIRY
number3600
Expiry for putObject pre signed URLs.
get-user-max-items
Get User API Max Items
GET_USER_MAX_ITEMS
number650
Specifies the maximum number of users for which details can be retrieved in a single API call.
redis.port
Redis Port
REDIS_PORT
number6379
Port for the Redis connection.
redis.host
Redis Host
REDIS_HOST
string127.0.0.1
Host for the Redis connection.
redis.username
Redis Username
REDIS_USERNAME
string
Username for the Redis connection.
redis.password
Redis Password
REDIS_PASSWORD
string
Password for the Redis connection.
redis.db
Redis Database Number
REDIS_DB
number0
Password for the Redis connection.
redis.key-prefix
Redis Key Prefix
REDIS_KEY_PREFIX
stringliquid:
Key prefix for Redis keys.
redis.channel-name
Redis Channel Name
REDIS_CHANNEL_NAME
stringliquid:
Channel name for Redis Publisher. Only set this if you use pusher events with Redis adapter.
system.queue-adapter
System Queue Adapter
SYSTEM_QUEUE_ADAPTER
stringrabbitmq
Specifies the queue adapter to use to send system events.
system.push-events
System Push Events
SYSTEM_PUSH_EVENTS
stringArrayuser.follow
Comma separated list of events in the format `event_class.event` that the system should push to queue. Related to `Can Use Push Events (privilege.can-use-push-events)`
system.push-events.prefix
System Push Events Prefix
SYSTEM_PUSH_EVENTS_PREFIX
stringliquid.
Prefix to be used for push events send by Liquid.
rabbitmq.connectionString
RabbitMQ Connection String
RABBITMQ_CONNECTION_STRING
stringamqp://localhost:5672
Connection string for RabbitMQ connection.
rabbitmq.channel-name
RabbitMQ Channel Name
RABBITMQ_CHANNEL_NAME
stringliquid-events
Channel name for RabbitMQ outbound events.
pusher.webhook.url
Pusher Webhook URL
PUSHER_WEBHOOK_URL
string
Webhook URL for the webhook pusher adapter. An HTTP POST request will be made to this URL with the push event object.
pusher.webhook.secret
Pusher Webhook Secret
PUSHER_WEBHOOK_SECRET
string
Secret key for generating the HMAC SHA256 signature for the webhook payload. Will be sent via the X-Webhook-Signature header.
cors.allowed-origins
Allowed Origins for CORS requests
CORS_ALLOWED_ORIGINS
stringArrayhttp://localhost:3000
Allowed origins for CORS requests.
cors.scan-interval
CORS Scan Interval
CORS_SCAN_INTERVAL
number300
Interval in seconds to scan for new origins.
privilege.can-use-cache
Can Use Cache
CAN_USE_CACHE
booleantrue
Specifies whether to use cache for optimizing API response time.
privilege.can-use-rabbitmq
Can Use RabbitMQ
CAN_USE_RABBITMQ
booleanfalse
Specifies whether system can use RabbitMQ.
privilege.can-use-push-events
Can Use Push Events
CAN_USE_PUSH_EVENTS
booleanfalse
Specifies if the system should publish certain events to RabbitMQ that can be used by external services.
privilege.can-use-webhook-pusher
Can Use Webhook Pusher
CAN_USE_WEBHOOK_PUSHER
booleanfalse
Specifies whether system can use Webhook Pusher.
privilege.can-use-follow-apis
Can Use Follow APIs
CAN_USE_FOLLOW_APIS
booleantrue
Specifies whether the application will allow users to use follow and unfollow mechanisms
privilege.can-use-profile-picture-apis
Can Use Profile Picture APIs
CAN_USE_PROFILE_PICTURE_APIS
booleanfalse
Specifies if users can use profile picture features. If enabled, you will require a S3 or S3-like cloud storage. Update options `Can Use Cloud Storage`, `S3 Access Key ID`, `S3 Access Key Secret`, `S3 Endpoint` and `S3 Bucket Name` along with this.
privilege.can-use-delegated-user-search-api
Can Use User Search API (Delegated)
CAN_USE_DELEGATED_USER_SEARCH_API
booleantrue
Specifies if users can search for other users in the system.
privilege.can-use-admin-user-search-api
Can Use User Search API (Admin)
CAN_USE_ADMIN_USER_SEARCH_API
booleantrue
Specifies if admins can search for other users in the system.
privilege.can-use-cloud-storage
Can Use Cloud Storage
CAN_USE_CLOUD_STORAGE
booleanfalse
Specifies if the application can use cloud storage.
privilege.can-use-phone-number
Can Use Phone Number On Signing Up
CAN_USE_PHONE_NUMBER
booleanfalse
Specifies if users can signup with phone numbers. Note that Liquid currently does not support verification of phone numbers. By default, all phone numbers are marked as unverified.
privilege.can-create-account
Can Use Create Account
CAN_CREATE_ACCOUNT
booleantrue
Specifies if users can signup into the service. If false, users can be created using the bulk create api at `users/admin-api/create` or `users/client-api/create`.
privilege.can-reset-password
Can Reset Password
CAN_RESET_PASSWORD
booleantrue
Specifies if users can reset their passwords using forgot password option.
privilege.can-use-credit-transaction-history
Can Use Credit Transaction History
CAN_USE_CREDIT_TRANSACTION_HISTORY
booleanfalse
Specifies if the application should maintain a history of credit changes for user accounts.
user.profile.username-validation-regex
User Profile Username Validation Regex
USER_PROFILE_USERNAME_VALIDATION_REGEX
string^[a-z_][a-z0-9._]*$
Specifies the regex to be used to validate username for user accounts.
user.profile.name-validation-regex
User Profile Name Validation Regex
USER_PROFILE_NAME_VALIDATION_REGEX
string^[\p{L}\p{M}'-]+$
Specifies the regex to be used to validate name for user accounts.
user.profile.password-validation-regex
User Profile Password Validation Regex
USER_PROFILE_PASSWORD_VALIDATION_REGEX
string
Specifies the regex to be used to validate password for user accounts.
user.profile.custom-data.hydrate-in-delegated-mode
User Profile Custom Data Hydrate In Delegated Mode
USER_PROFILE_CUSTOM_DATA_HYDRATE_IN_DELEGATED_MODE
booleanfalse
Specifies if custom data has to be sent in delegated/general use APIs. This option does not hide custom data from admin and client APIs. For controlling custom data visibility in GET /user/me, the option `user.profile.custom-data.hydrate-in-self-retrieval` should be adjusted.
user.profile.custom-data.hydrate-in-self-retrieval
User Profile Custom Data Hydrate In Self Retrieval
USER_PROFILE_CUSTOM_DATA_HYDRATE_IN_SELF_RETRIEVAL
booleantrue
Specifies if custom data has to be sent in while hitting GET /user/me. This option works independent of the value in option `user.profile.custom-data.hydrate-in-delegated-mode`.
user.login.history-record-expires-in
User Login History Record Expires In
USER_LOGIN_HISTORY_RECORD_EXPIRES_IN
number86400
Specifies in seconds the amount of time after which login history records will expire. By default this data is stored for upto 24 hours.
user.login.record-successful-attempts
User Login Record Successful Attempts
USER_LOGIN_RECORD_SUCCESSFUL_ATTEMPTS
booleantrue
Specifies if successful login attempts should be logged.
user.login.record-failed-attempts
User Login Record Failed Attempts
USER_LOGIN_RECORD_FAILED_ATTEMPTS
booleantrue
Specifies if failed login attempts should be logged.
user.login.require-user-agent
User Login Require User Agent
USER_LOGIN_REQUIRE_USER_AGENT
booleantrue
Specifies if user agent should be mandated in login requests.
user.account-creation.require-email-verification
User Account Creation Require Email Verification
USER_ACCOUNT_CREATION_REQUIRE_EMAIL_VERIFICATION
booleantrue
Specifies if email verification is required while signing up in the service. Also modify `user.account-creation.require-email-verification` in your frontend app config.
user.account-creation.enable-invite-only
User Account Creation Enable Invite Only
USER_ACCOUNT_CREATION_ENABLE_INVITE_ONLY
booleanfalse
Specifies if accounts can be created only using an invite code.
user.account-creation.force-generate-invite-codes
User Account Creation Force Generate Invite Codes
USER_ACCOUNT_CREATION_FORCE_GENERATE_INVITE_CODES
booleanfalse
Specifies if the system can generate invite codes on account creation even if `user.account-creation.enable-invite-only` option is turned off.
user.account-creation.invites-per-person
User Account Creation Invites Per Person
USER_ACCOUNT_CREATION_INVITES_PER_PERSON
number5
Specifies the number of invites a person can make.
invite-only.code-generation.max-limit-per-request
Invite Only Code Generation Max Limit Per Request
INVITE_CODE_CODE_GENERATION_MAX_LIMIT_PER_REQUEST
number15
Specifies the maximum number of invite codes that can be generated for a user per request from admin and client APIs.
user.account-creation.invite-code-availability-window
User Account Creation Invite Code Availability Window
USER_ACCOUNT_CREATION_INVITE_CODE_AVAILABILITY_WINDOW
number10
Specifies the window size in seconds to have been ellapsed since user account creation after which users can get their invite codes.
user.account-creation.allow-only-whitelisted-email-domains
User Account Creation Allow Only Whitelisted Email Domains
USER_ACCOUNT_CREATION_ALLOW_ONLY_WHITELISTED_EMAIL_DOMAINS
booleanfalse
Specifies if account creation API should allow only the whitelisted email domains in email field.
user.account-creation.whitelisted-email-domains
User Account Creation Whitelisted Email Domains
USER_ACCOUNT_CREATION_WHITELITED_EMAIL_DOMAINS
stringArraygmail.com,googlemail.com,outlook.com,live.com,live.fr,live.co.uk,live.nl,live.it,live.com.au,live.ca,hotmail.com,hotmail.co.uk,hotmail.fr,hotmail.it,hotmail.es,hotmail.de,yahoo.com,yahoo.fr,yahoo.co.uk,yahoo.com.br,yahoo.co.in,hotmail.de,rocketmail.com,yahoo.in,yahoo.ca,yahoo.com.au,yahoo.com.ar,yahoo.com.mx,yahoo.com.sg,mac.com,msn.com,icloud.com,mail.com,yandex.ru,proton.me,protonmail.com
Comma separated list of domain names allowed for user sign up. Particularly useful to prevent users from using disposable emails.
user.account-creation.sanitize-gmail-addresses
User Account Creation Sanitize Gmail Addresses
USER_ACCOUNT_CREATION_SANITIZE_GMAIL_ADDRESSES
booleantrue
Specifies if Gmail addresses should be sanitized before writing and reading from the database. This prevents users from creating duplicate accounts by inserting dots in their email. Check https://support.google.com/mail/answer/7436150 for more info.
user.account-creation.enable-ip-based-throttle
User Account Creation Enable IP Based Throttle
USER_ACCOUNT_CREATION_ENABLE_IP_BASED_THROTTLE
booleanfalse
Specifies if creating multiple accounts from the same IP should be throttled for a specified amount of time.
user.account-creation.ip-based-throttle.window-size
User Account Creation IP Based Throttle Window Size
USER_ACCOUNT_CREATION_IP_BASED_THROTTLE_WINDOW_SIZE
number86400
Specifies the window size in seconds to throttle the account creation. Default is 24 hours.
user.account-creation.initial-credit-count
User Account Creation Initial Credit Count
USER_ACCOUNT_CREATION_INITIAL_CREDIT_COUNT
number0
Specifies the initial amount of credits user accounts will have after creation.
user.account-creation.default-scope
User Account Creation Default Scope
USER_ACCOUNT_CREATION_DEFAULT_SCOPE
stringArraydelegated:all
Comma separated list of scopes that should be assigned to users accounts when they are created.
user.account-creation.custom-data.default-value
User Account Creation Custom Data Default Value
USER_ACCOUNT_CREATION_CUSTOM_DATA_DEFAULT_VALUE
string{}
Valid JSON string that should be assigned to users account customData field when they are created.
user.account-creation.preserve-unverified-user-id
User Account Creation Preserve Unverified User ID
USER_ACCOUNT_CREATION_PRESERVE_UNVERIFIED_USER_ID
booleantrue
Specifies if the system should preserve the existing unverified user's ID when replacing them with a new user registration using the same credentials.
user.account-creation.verificaton-code-lifetime
User Account Creation Verificaton Code Lifetime
USER_ACCOUNT_CREATION_VERIFICATION_CODE_LIFETIME
number3600
Expiry time in seconds for verification codes.
user.account-creation.sso.google.enabled
User Account Creation Enable Google SSO
USER_ACCOUNT_CREATION_SSO_GOOGLE_ENABLED
booleanfalse
Specifies if Google signon should be enabled.
user.account-creation.sso.google.client-id
User Account Creation Google SSO Client ID
USER_ACCOUNT_CREATION_SSO_GOOGLE_CLIENT_ID
string
Specifies the client ID for Google SSO.
user.account-creation.sso.google.client-secret
User Account Creation Google SSO Client Secret
USER_ACCOUNT_CREATION_SSO_GOOGLE_CLIENT_SECRET
string
Specifies the client secret for Google SSO.
user.account-creation.sso.google.use-given-name-as-last-name
User Account Creation Google SSO Use Given Name As Last Name
USER_ACCOUNT_CREATION_SSO_GOOGLE_USE_GIVEN_NAME_AS_LAST_NAME
booleantrue
Specifies if the given name should be used as the last name when family name is not available from Google profile.
user.profile.update.require-current-password
User Profile Update Require Current Password
USER_PROFILE_UPDATE_REQUIRE_CURRENT_PASSWORD
booleantrue
Specifies if the current password is required when updating protected fields in the profile.
user.profile.update.protected-fields
User Profile Update Protected Fields
USER_PROFILE_UPDATE_PROTECTED_FIELDS
stringArraypassword
Comma separated list of fields that require current password to be updated.
user.login.sso.token-lifetime
User Login Google SSO Token Lifetime
USER_LOGIN_SSO_GOOGLE_SSO_TOKEN_LIFETIME
nummber600
Specifies the lifetime of the token generated by Google SSO login sesion in seconds.
user.profile.editable-fields
Profile Editable Fields
USER_PROFILE_EDITABLE_FIELDS
stringArrayfirstName,lastName,middleName,password,bio,pronouns,customLink,organization,gender,preferredLanguage
Comma specified list of fields that are editable by edit profile API.
admin-api.user.profile.editable-fields
Profile Editable Fields (Admin API)
ADMIN_API_USER_PROFILE_EDITABLE_FIELDS
stringArrayusername,email,password,isDeleted,role,firstName,lastName,middleName,bio,pronouns,customLink,organization,designation,gender,preferredLanguage,country
Comma specified list of fields that are editable by edit profile API.
client-api.user.profile.editable-fields
Profile Editable Fields (Client API)
CLIENT_API_USER_PROFILE_EDITABLE_FIELDS
stringArrayusername,email,password,isDeleted,role,firstName,lastName,middleName,bio,pronouns,customLink,organization,designation,gender,preferredLanguage,country
Comma specified list of fields that are editable by edit profile API.
client.id-validation-regex
Client ID Validation Regex
CLIENT_ID_VALIDATION_REGEX
string^[a-z_][a-z0-9._]*$
Specifies the regex to be used to validate id for clients.
admin-api.user.profile.can-edit-peer-data
Profile Can Edit Peer Profile Data (Admin API)
ADMIN_API_USER_PROFILE_CAN_EDIT_PEER_DATA
booleantrue
Specifies if roles with equal rank can edit profile data of each other.
user.search.search-fields
User Search Fields
USER_SEARCH_SEARCH_FIELDS
stringArrayusername,firstName,lastName,email,role
Specifies the field names that can be used to search for users.
user.search.strict-match-fields
User Search Strict Match Fields
USER_SEARCH_STRICT_MATCH_FIELDS
stringArray
Specifies the fields that should be returned only if the search query matches the string in the field exactly. The field should also be a part of `user.search.search-fields`.
privilege.user.search.can-use-id
Can Use ID for User Search
USER_SEARCH_CAN_USE_ID
booleantrue
Specifies if _id field of records can be used to search for users.
privilege.user.search.can-use-fullname
Can Use Fullname for User Search
USER_SEARCH_CAN_USE_FULLNAME
booleantrue
Specifies if firstName and lastName fields can be concatenated and used to search for users.
user.search-results.cache-lifetime
User Search Results Cache Lifetime
USER_SEARCH_RESULTS_CACHE_LIFETIME
number30
Specifies in seconds the amount of time for which results for a search query will be cached.
user.field-privacy.non-follower.hidden-fields
User Field Non-Follower Hidden Fields
USER_FIELD_PRIVACY_NON_FOLLOWER_HIDDEN_FIELDS
stringArrayemail,phone,secondaryEmail,secondaryPhone,isBanned,credits,scope,restricted,customData
Specifies fields that should be hidden when accounts are retrieved by people who are not following a user.
user.search-results.limit
User Search Results Limit
USER_SEARCH_RESULTS_LIMIT
number10
Specifies the maximum number of results to be returned in user search API.
admin-api.user.search.search-fields
User Search Fields (Admin API)
ADMIN_API_USER_SEARCH_SEARCH_FIELDS
stringArrayusername,firstName,lastName,email
Specifies the field names that can be used to search for users.
admin-api.privilege.user.search.can-use-id
Can Use ID for User Search (Admin API)
ADMIN_API_USER_SEARCH_CAN_USE_ID
booleantrue
Specifies if _id field of records can be used to search for users.
admin-api.privilege.user.search.can-use-fullname
Can Use Fullname for User Search (Admin API)
ADMIN_API_USER_SEARCH_CAN_USE_FULLNAME
booleantrue
Specifies if firstName and lastName fields can be concatenated and used to search for users.
admin-api.user.search-results.cache-lifetime
User Search Results Cache Lifetime (Admin API)
ADMIN_API_USER_SEARCH_RESULTS_CACHE_LIFETIME
number30
Specifies in seconds the amount of time for which results for a search query will be cached.
admin-api.user.search-results.limit
User Search Results Limit (Admin API)
ADMIN_API_USER_SEARCH_RESULTS_LIMIT
number10
Specifies the maximum number of results to be returned in user search API.
admin-api.user.search.strict-match-fields
User Search Strict Match Fields (Admin API)
ADMIN_API_USER_SEARCH_STRICT_MATCH_FIELDS
stringArrayrole
Specifies the fields that should be returned only if the search query matches the string in the field exactly. The field should also be a part of `admin-api.user.search.search-fields`.
client-api.user.search.search-fields
User Search Fields (Client API)
CLIENT_API_USER_SEARCH_SEARCH_FIELDS
stringArrayusername,firstName,lastName,email
Specifies the field names that can be used to search for users.
client-api.user.search.strict-match-fields
User Search Strict Match Fields (Client API)
CLIENT_API_USER_SEARCH_STRICT_MATCH_FIELDS
stringArrayrole
Specifies the fields that should be returned only if the search query matches the string in the field exactly. The field should also be a part of `client-api.user.search.search-fields`.
client-api.user.search-results.cache-lifetime
User Search Results Cache Lifetime (Client API)
CLIENT_API_USER_SEARCH_RESULTS_CACHE_LIFETIME
number30
Specifies in seconds the amount of time for which results for a search query will be cached.
client-api.user.search-results.limit
User Search Results Limit (Client API)
CLIENT_API_USER_SEARCH_RESULTS_LIMIT
number10
Specifies the maximum number of results to be returned in user search API.
client-api.privilege.user.search.can-use-id
Can Use ID for User Search (Client API)
CLIENT_API_USER_SEARCH_CAN_USE_ID
booleantrue
Specifies if _id field of records can be used to search for users.
client-api.privilege.user.search.can-use-fullname
Can Use Fullname for User Search (Client API)
CLIENT_API_USER_SEARCH_CAN_USE_FULLNAME
booleantrue
Specifies if firstName and lastName fields can be concatenated and used to search for users.
user.block-status.cache-lifetime
User Block Status Cache Lifetime
USER_BLOCK_STATUS_CACHE_LIFETIME
number60
Specifies in seconds the amount of time for which block status will be cached.
user.subscription.tier-list
User Subscription Tier List
USER_SUBSCRIPTION_TIER_LIST
stringArraybasic,premium
Comma separated list of subscription tier names.
user.subscription.base-tier
User Subscription Base Tier
USER_SUBSCRIPTION_BASE_TIER
stringbasic
Specifies the basic tier of the subscription. When a user's subscription expires, they will be reverted to the base tier.
user.profile-picture.max-file-size
User Profile Picture Max File Size
USER_PROFILE_PICTURE_MAX_FILE_SIZE
number500000
Specifies in bytes the max file size for user profile pictures.
user.profile-picture.signed-url.expiry
User Profile Picture Signed URL Expiry
USER_PROFILE_PICTURE_SIGNED_URL_EXPIRY
number14400
Specifies in seconds the expiry time for user profile picture links.
pagination.default-limit
Pagination Default Limit
PAGINATION_DEFAULT_LIMIT
number10
Specifies the default number of results to be returned in paginated APIs
pagination.max-limit
Pagination Max Limit
PAGINATION_MAX_LIMIT
number1000
Specifies the maximum number of results to be returned in paginated APIs
system.rate-limit.window-size
Rate Limit Window Size
SYSTEM_RATE_LIMIT_WINDOW_SIZE
number60
Window size (in seconds) for rate limiting.
system.rate-limit.light-api-max-limit
Light API Max Limit
SYSTEM_RATE_LIMIT_LIGHT_API_MAX_LIMIT
number75
Specifies the rate limit for light APIs for the specified window size.
system.rate-limit.medium-api-max-limit
Medium API Max Limit
SYSTEM_RATE_LIMIT_MEDIUM_API_MAX_LIMIT
number30
Specifies the rate limit for medium APIs for the specified window size.
system.rate-limit.heavy-api-max-limit
Heavy API Max Limit
SYSTEM_RATE_LIMIT_HEAVY_API_MAX_LIMIT
number10
Specifies the rate limit for heavy APIs for the specified window size.
system.rate-limit.extreme-api-max-limit
Extreme API Max Limit
SYSTEM_RATE_LIMIT_EXTREME_API_MAX_LIMIT
number5
Specifies the rate limit for extreme APIs for the specified window size.
system.rate-limit.count-by-route
Rate Limiter Count By Route
SYSTEM_RATE_LIMIT_COUNT_BY_ROUTE
booleantrue
Specifies if the rate limit counter should be incremented per route per IP instead of just the IP. This means rate limit will be counted independendly for every API.
system.role.default
System Default Role
SYSTEM_DEFAULT_ROLE
stringuser
Specifies the default role to be used when users are signing up.
2fa.email.enabled
2FA Enabled
2FA_EMAIL_ENABLED
booleanfalse
Specifies if users can enable 2 factor authentication.
2fa.email.enforce
2FA Enforce
2FA_EMAIL_ENFORCE
booleanfalse
Specifies if users are enforced to authenticate with 2 factor authentication.
system.exposed-options
System Exposed Options
SYSTEM_EXPOSED_OPTIONS
stringArray["system.app-name","admin-api.user.profile.can-edit-peer-data","pagination.default-limit","pagination.max-limit","user.account-creation.invites-per-person","user.account-creation.invite-code-availability-window"]
Comma separated list of options that a user can have access to after logging in. This will also include insecure settings.
system.exposed-options.insecure
System Exposed Options (Public)
SYSTEM_EXPOSED_OPTIONS_INSECURE
stringArray["privilege.can-create-account","privilege.can-use-phone-number","user.account-creation.enable-invite-only","user.account-creation.require-email-verification","privilege.can-reset-password","user.login.require-browser-info","user.login.require-os-info","user.account-creation.sso.google.enabled","user.password-reset.require-current-password"]
Comma separated list of options that a user can have access to before logging in.