PlautiSupport Portal

Environment Values

If needed, configure the Plauti Server installation by adjusting its Environment Values (Env Values).

Directions for use of the Env Values

Overriding Env Values

To override default values, set the corresponding key in your env.properties, config.json, or process.env (environment variable).

Load Order

Values are loaded in the following order, meaning any value you provide will be used first:

  1. env.properties in your current working directory

  2. Internal configuration (config.json, env.config.jsonc)

  3. Environment variables (process.env)

  4. Built-in defaults (as displayed in the list below)

Validation

  • All environment values must be strings or string lists (where applicable).
    A string-list is a basic string with key=value1,value2,value3
  • Validation is performed using schema validation; invalid, missing, or null values for required fields will throw errors at runtime.
  • Double check that all required keys are set for your platform and environment.
  • For list values (e.g., ALERTEMAILLIST), supply a comma-separated list.
  • For secrets, use strong, random values of the required length.
  • If you see a validation error, look for missing required keys, typos in key names, invalid email addresses, or incorrectly formatted values.

The default Environment Values

Note:

  • For secret/private keys, only the type is shown for security reasons.
  • If a key is marked as required = " yes ", then either this key or its counterpart (as indicated) is required, not both.
Name Type Default Required Description
HOST string 0.0.0.0 no The interface/IP the server will bind to for listening.
PORT number 8881 no The port number the server will listen on.
APPURL string : url (must be provided for correct operation) no The URL where this server instance is accessible.
FRONTENDURL string : url (defaults to APPURL) no The URL of the frontend application.
CORSALLOWLIST string array : list ( url1,url2 ) (string-list) no

Comma-separated list or array of origins allowed for CORS requests.

|
|

ALERTEMAILLIST

|

string | array : list (email1,email2)

|

(empty list)

|

no

|

List of emails to receive alerts. Must be valid emails.

|
|

LOGFILE

|

string

|

plautiserver.log

|

no

|

Log file path/name for server logs.

|
|

LOGLEVEL

|

string : debug,error,warn,verbose,log

|

debug

|

no

|

Logging verbosity: one of debug, info, log, verbose, warn, error, fatal.

|
|

DATABASEURL

|

string

|

server.db

|

no

|

The database connection URI.

|
|

DATAENCRYPTKEY

|

string : min 9

|

|

yes

|

Key used for encrypting sensitive data at rest.

|
|

JWTSECRET

|

string

|

|

yes

|

Secret for signing JWT tokens.

|
|

JWTLIFETIME

|

string

|

1h

|

no

|

The lifetime of JWT tokens (e.g., 1h, 7d).

|
|

REFRESHJWTSECRET

|

string

|

|

yes

|

Secret for signing refresh JWT tokens.

|
|

REFRESHJWTLIFETIME

|

string

|

1d

|

no

|

The lifetime of refresh JWT tokens (e.g., 1d, 30d).

|
|

SFLOGINURL

|

string : url

|

https://test.salesforce.com/

|

no

|

Salesforce login endpoint URL.

|
|

SFLOGINCLIENTID

|

string (provided by default)

|

|

yes

|

Salesforce OAuth client ID for login.

|
|

SFLOGINCLIENTSECRET

|

string (provided by default)

|

|

yes

|

Salesforce OAuth client secret for login.

|
|

SFCONNECTCLIENTID

|

string (provided by default)

|

|

yes

|

Salesforce OAuth client ID for connect.

|
|

SFCONNECTCLIENTSECRET

|

string (provided by default)

|

|

yes

|

Salesforce OAuth client secret for connect.

|
|

AZURETENANTID

|

string (provided by default)

|

|

yes

|

Azure directory (tenant) ID.

|
|

AZURELOGINCLIENTID

|

string (provided by default)

|

|

yes

|

Azure OAuth client ID for login.

|
|

AZURELOGINCLIENTSECRET

|

string (provided by default)

|

|

yes

|

Azure OAuth client secret for login.

|
|

AZURECONNECTCLIENTID

|

string (provided by default)

|

|

yes

|

Azure OAuth client ID for connect.

|
|

AZURECONNECTCLIENTSECRET

|

string (provided by default)

|

|

yes

|

Azure OAuth client secret for connect.

|
|

MAXIMUMAMOUNTOFCPUS

|

number

|

4

|

no

|

Upper limit for CPUs that can be used by the application/process.

|
|

MAXIMUMAMOUNTOFPROCESSES

|

number

|

4

|

no

|

Upper limit for processes that can be spawned by the application.

|
|

MSTENANTID

|

string

|

|

yes

|

Microsoft tenant ID. Required if SFORGANIZATIONID not set.

|
|

SFORGANIZATIONID

|

string

|

|

yes

|

Salesforce organization ID. Required if MSTENANTID not set.

|
|

SFLOGINCLIENTURI

|

string (empty by default)

|

|

no

|

Salesforce URI for login, be aware that this key is not dynamic with the usage of sandbox orgs.

|
|

SFCONNECTCLIENTURI

|

string (empty by default)

|

|

no

|

Salesforce URI for connect, be aware that this key is not dynamic with the usage of sandbox orgs.

|