Skip to main content

Configuration

Find below a list of all environment variables that can be set at launch to configure different portions of the application:

General

KeyTypeRequired
BASE_URLstringtrue
PORTnumbertrue
APP_SECRETstringtrue

Database

KeyTypeRequired
DB_HOSTstringtrue
DB_USERNAMEstringtrue
DB_PORTnumbertrue
DB_DATABASEstringtrue

Queue

KeyTypeRequired
QUEUE_DRIVERsqs or redis or memorytrue
AWS_SQS_QUEUE_URLstringIf driver is SQS
AWS_REGIONstringIf driver is SQS
AWS_ACCESS_KEY_IDstringIf driver is SQS
AWS_SECRET_ACCESS_KEYstringIf driver is SQS
REDIS_HOSTstringIf driver is Redis
REDIS_PORTstringIf driver is Redis
REDIS_TLSbooleanfalse
REDIS_CONCURRENCYnumberfalse

Redis

KeyTypeRequired
REDIS_HOSTstringtrue
REDIS_PORTstringtrue
REDIS_TLSbooleanfalse
REDIS_USERNAMEstringfalse
REDIS_PASSWORDstringfalse

Storage

See the Storage page for more details on how to use different storage options.

KeyTypeRequired
STORAGE_BASE_URLstringtrue
STORAGE_DRIVERs3 or localtrue
STORAGE_S3_BUCKETstringIf driver is S3
STORAGE_S3_ENDPOINTstringfalse
STORAGE_S3_FORCE_PATH_STYLEbooleanfalse
AWS_REGIONstringIf driver is S3
AWS_ACCESS_KEY_IDstringIf driver is S3
AWS_SECRET_ACCESS_KEYstringIf driver is S3

Auth

KeyTypeRequired
AUTH_DRIVERbasic, google, openid, samltrue
AUTH_BASIC_EMAILstringIf driver is Basic
AUTH_BASIC_PASSWORDstringIf driver is Basic
AUTH_BASIC_NAMEstringfalse
AUTH_SAML_CALLBACK_URLstringIf driver is SAML
AUTH_SAML_ENTRY_POINT_URLstringIf driver is SAML
AUTH_SAML_ISSUERstringIf driver is SAML
AUTH_SAML_CERTstringIf driver is SAML
AUTH_SAML_IS_AUTHN_SIGNEDbooleanIf driver is SAML
AUTH_SAML_NAMEstringfalse
AUTH_OPENID_ISSUER_URLstringIf driver is OpenID
AUTH_OPENID_CLIENT_IDstringIf driver is OpenID
AUTH_OPENID_CLIENT_SECRETstringIf driver is OpenID
AUTH_OPENID_REDIRECT_URIstringIf driver is OpenID
AUTH_OPENID_DOMAIN_WHITELISTstringIf driver is OpenID
AUTH_OPENID_NAMEstringfalse
AUTH_GOOGLE_ISSUER_URLstringIf driver is Google
AUTH_GOOGLE_CLIENT_IDstringIf driver is Google
AUTH_GOOGLE_CLIENT_SECRETstringIf driver is Google
AUTH_GOOGLE_NAMEstringfalse

Tracking

KeyTypeRequired
TRACKING_LINK_WRAPbooleanfalse
TRACKING_DEEPLINK_MIRROR_URLstringfalse

Error Handling

Parcelvoy supports both logging information about the system to the terminal as well as logging errors to either Bugsnag or Sentry.

KeyTypeRequiredDescription
LOG_LEVELinfo, trace, warn, errorfalseWhat segment of logs to output
LOG_COMPILED_MESSAGEbooleanfalseShould the entire message from a send be stored in the event table
LOG_PRETTY_PRINTbooleanfalseShould logs pretty print to terminal
ERROR_DRIVERsentry, bugsnag or loggerfalseWhat error handling client to use
ERROR_BUGSNAG_API_KEYstringIf driver is BugsnagThe API key to the Node.js Bugsnag project
ERROR_SENTRY_DSNstringIf driver is SentryThe DNS for the Sentry Node.js project