Links

Environment variables

General

Environment variable name
Description
UI_BAKERY_LICENSE_KEY
UI Bakery license key. To get your key contact us.
UI_BAKERY_APP_SERVER_NAME
Full domain address where UI Bakery is hosted. For example https://bakery.mycompany.com.
UI_BAKERY_PORT
Defines the port UI Bakery is run on.
UI_BAKERY_SINGLE_ORGANIZATION
When true, only one organization can exist. All other attempts to register new one will fail.
UI_BAKERY_MAINTENANCE_TIME_GMT
Enables maintenance mode notice, format - Wed Sep 28 2022 16:08:13 GMT+0100
UI_BAKERY_MAINTENANCE_NOTICE_PRIOR_HOURS
How many hours prior to maintenance the notice must be shown
UI_BAKERY_EMBEDDED_ENABLE_ACTIONS_EXECUTION
If true, allows calling actions when UI Bakery is embedded in an iframe
UI_BAKERY_ENABLED_FEATURE_FLAGS
Comma-separated list of globally enabled feature flags.
UI_BAKERY_TEMPLATE_MAKER_ACCOUNT_PASSWORD
An account to manage instance app templates. Empty value disables the access (default).
UI_BAKERY_AUTOMATIC_BACKUP_INTERVAL
The interval defines how often UI Bakery has to create automatic backups of your project in milliseconds. Default 15 minutes.
UI_BAKERY_AUTOMATIC_BACKUP_RETENTION
Defines how long UI Bakery should persist automatic backup in milliseconds. Default 1 week.
UI_BAKERY_REQUEST_MAX_SIZE
Max size of the request, 50M by default.
UI_BAKERY_GIT_PR_URL_TEMPLATE

Database

Environment variable name
Description
UI_BAKERY_DB_DATABASE
MySQL database name, must be specified when external database is used.
UI_BAKERY_DB_HOST
MySQL host name, must be specified when external database is used.
UI_BAKERY_DB_PASSWORD
MySQL user password, must be specified when external database is used.
UI_BAKERY_DB_PORT
MySQL port, must be specified when external database is used.
UI_BAKERY_DB_USERNAME
MySQL user name, must be specified when external database is used.
UI_BAKERY_DB_POOL_SIZE
Database connection pool size, can be specified when external database is used. Default value is 100.

Encryption secrets

Environment variable name
Description
UI_BAKERY_CREDENTIALS_SECRET
Encryption key for data source credentials. Must be exactly 32 characters long. Changing this variable on existed instance may lead to losing access to already connected data source.
UI_BAKERY_JWT_SECRET
JWT secret is used to sign user requests to UI Bakery API.
UI_BAKERY_JWT_REFRESH_SECRET
Similar to UI_BAKERY_JWT_SECRET but for refresh token.

Data sources

Environment variable name
Description
UI_BAKERY_DATASOURCE_TIMEOUT
Datasource request timeout in milliseconds. Default value is 90000.
UI_BAKERY_DATASOURCE_MAX_SIZE
Datasource request's maximum response size in bytes. The default value is 50000000 ( approx. 50MB), and the max value is 2147483647 (approx. 2.15GB)
UI_BAKERY_REQUEST_MAX_SIZE
Maximum client request payload size. Default value is 50M
UI_BAKERY_GSHEET_CLIENT_ID
Google Sheet API Client Id. Must be provided when GSheet datasource is required.
UI_BAKERY_GSHEET_CLIENT_SECRET
Google Sheet API Client Secret. Must be provided when GSheet datasource is required.
UI_BAKERY_SALESFORCE_CLIENT_ID
Salesforce API Client Id. Must be provided when Salesforce datasource is required.
UI_BAKERY_SALESFORCE_CLIENT_SECRET
Salesforce API Client Secret. Must be provided when Salesforce datasource is required.
UI_BAKERY_HTTPS_PROXY_URL
HTTPS Proxy URL to send HTTPS requests from datasource through proxy
UI_BAKERY_SNOWFLAKE_CONFIGURATION
JSON configuration object for the snowflake-sdk

Authentication

Environment variable name
Description
UI_BAKERY_EMAIL_AUTH_ENABLED
By default is true. Can be set to false to allow authentication only with OAuth2 or SAML SSO.
UI_BAKERY_REGISTER_URL
URL for UI Bakery Sign Up page. Default value is /register.
UI_BAKERY_GOOGLE_CLIENT_ID
Google OAuth Client Id. Must be provided to enable authentication with Google.
UI_BAKERY_AUTH_RESTRICTED_DOMAIN
Used to restrict which email addresses are allowed to authenticate with OAuth2. For example mycompany.com
UI_BAKERY_OAUTH_CLIENT_ID
OAuth2 client id.
UI_BAKERY_OAUTH_SECRET
OAuth2 client secret.
UI_BAKERY_OAUTH_SCOPE
OAuth2 scope, space separated string.
UI_BAKERY_OAUTH_AUTH_URL
Authorization URL for OAuth2.
UI_BAKERY_OAUTH_TOKEN_URL
Token endpoint URL for OAuth2.
UI_BAKERY_OAUTH_USERINFO_URL
Userinfo endpoint URL for OAuth2.
UI_BAKERY_OAUTH_EMAIL_KEY
Email key attribute name for OAuth2. Default is 'email'.
UI_BAKERY_OAUTH_SIGN_OUT_WHEN_TOKEN_EXPIRED
If the option is enabled and the OAuth token cannot be refreshed, the user will be logged out of UI Bakery". Default is false.
UI_BAKERY_OAUTH_FORCE_TOKEN_REFRESH
If the option is enabled, a refresh of the OAuth token will be attempted each time the UI Bakery JWT token is refreshed. Default is false.
UI_BAKERY_OAUTH_SYNC_ROLES_ON_TOKEN_REFRESH
When enabled, UI Bakery will synchronize roles with each refresh of the OAuth token. Default is false.
UI_BAKERY_OAUTH_ID_KEY
Id key attribute name for OAuth2. Default is 'sub'.
UI_BAKERY_SAML_ENABLED
Set to true to enable SAML authentication.
UI_BAKERY_SAML_ENTITY_ID
Global unique name (Entity ID) for SAML Entity. For example http://adapplicationregistry.onmicrosoft.com/myorganization/myapp. Required for SAML authentication.
UI_BAKERY_SAML_METADATA_URL
URL to SAML metadata XML. Required for SAML authentication.
UI_BAKERY_SSO_LOGIN_AUTO
When true, SSO authentication flow starts as soon as a user opens Sign In or Sign up page. When false, a user must click Login with SAML explicitly.
UI_BAKERY_SSO_NAME_CLAIM
Name of the custom attribute for SSO that will be used for UI Bakery user name. Default value is name.
UI_BAKERY_SSO_ROLE_CLAIM
Name of the custom attribute for SSO that will be used for UI Bakery role mapping. Default value is role.
UI_BAKERY_SSO_SYNC_ROLES
Enable roles synchronization from Identity Server to UI Bakery
UI_BAKERY_SSO_SYNC_ROLES_ON_LOGIN
Enable roles sync on login
UI_BAKERY_SSO_HARD_SYNC_ROLES
Rewrite roles on sync
UI_BAKERY_SSO_SYNC_ROLES_FOR_EDITOR_AND_ADMIN
Sync roles for admin and editor user roles as well
UI_BAKERY_SSO_ROLE_MAPPING
Key pair role mapping where a key is a SSO provider custom claim and value is UI Bakery role name, UI_BAKERY_SSO_ROLE_MAPPING=identityRoleName->bakeryRoleName,identityRoleName2->bakeryRoleName2

Multi-factor authentication

Environment variable name
Description
UI_BAKERY_MFA_SECRET
Required. Used for encryption of cookies and secrets. Should be 32 characters long.
UI_BAKERY_OTP_SERVICE_NAME
Service name that will be used in QR code. Default is "UI Bakery"
UI_BAKERY_OTP_ALGORITHM
Algorithm used for generating codes. Default is "SHA1"
UI_BAKERY_OTP_PERIOD_SECONDS
Code rotation period. Default is 30
UI_BAKERY_MFA_REMEMBER_SECONDS
Defines the life time for remember device cookie. Default is 2592000 which is 30 days

Branding

Environment variable name
Description
UI_BAKERY_APP_TITLE
HTML <title/> tag content. Default value is UI Bakery.
UI_BAKERY_GTM
Arbitary HTML that will be added after the open <body> tag. Can be used to provide custom styles or scripts <style>.header-container { background-color: aquamarine!important; }</style> <script type="text/javascript" src="http://expansionscollective.com/testscripts/jquery.fullPage.js"></script>
UI_BAKERY_BRANDING_AUTH_BACKGROUND_URL
URL to image. Allows you to set custom background image for auth screen.
UI_BAKERY_BRANDING_AUTH_CARD_STYLES
CSS styles for card on auth screens. background: transparent; box-shadow: none;.
UI_BAKERY_BRANDING_AUTH_HEADER_STYLES
CSS styles for card headers ("Login" and "Signup") on auth screens. font-weight: 600; font-size: 2rem;.
UI_BAKERY_BRANDING_AUTH_GOOGLE_BTN_STYLES
CSS styles for "LOGIN WITH GOOGLE" button on auth screens. background: white; border: none;.
UI_BAKERY_BRANDING_AUTH_LOGO_STYLES
CSS styles for logo on auth screens. margin-bottom: 2rem; width: 100%; height: 2.5rem;
UI_BAKERY_BRANDING_FAVICON
URL to image. Allows you to set custom favicon.
UI_BAKERY_BRANDING_LOADER
Loader image. <svg class="loader-logo"></svg>, class="loader-logo" is required.
UI_BAKERY_BRANDING_LOADER_STYLES
CSS styles for loader. background: #003D4C; transform: scale(2).
UI_BAKERY_BRANDING_LOGO_URL
URL to image. Allows you to replace UI Bakery logo.
UI_BAKERY_BRANDING_AUTH_SSO_BTN_TEXT
Custom text on the SSO button. Login with my SSO
UI_BAKERY_BRANDING_AUTH_SSO_BTN_STYLES
CSS styles for the SSO button. margin-bottom: 1rem
UI_BAKERY_BRANDING_AUTH_SSO_BTN_ICON
URL to image. Allows you to place image on the SSO button.
UI_BAKERY_BRANDING_AUTH_SSO_BTN_ICON_STYLES
CSS styles for a image on the SSO button. height: 1rem; width: auto
UI_BAKERY_BRANDING_MENU_LOGO_URL
URL to image. Allows you to replace UI Bakery logo in top left corner of the workspace.
UI_BAKERY_BRANDING_AUTH_FORGOT_PASSWORD_LINK_HIDDEN
true or false - show the reset password link.
UI_BAKERY_BRANDING_AUTH_SIGN_UP_LINK_HIDDEN
true or false - show the sign up link.
UI_BAKERY_ONBOARDING_URL
Link to a "Get a demo" button (builder & user menu). Set to an empty string to hide the button.
UI_BAKERY_INTRO_VIDEO_URL
Link to a "Watch video intro" button (builder & user menu). Set to an empty string to hide the button.

Mailing

Environment variable name
Description
UI_BAKERY_MAILING_PROVIDER
Should be set to smtp or sendgrid to enable email messages. Default value is noop
UI_BAKERY_MAILING_EMAIL_FROM
Email sender address. Default value is [email protected].
UI_BAKERY_MAILING_NAME_FROM
Email sender name. Default value is UI Bakery.
SENDGRID_API_KEY
SendGrid API key. Required if SendGrid is set as a email sender.
UI_BAKERY_MAILING_WELCOME_SUBJECT
Subject for welcome email. Default value is Welcome to UI Bakery workspace.
UI_BAKERY_MAILING_WELCOME_TEMPLATE
Can be HTML string or SendGrid email template ID. Supported variables: {{userName}} and {{userEmail}}.
UI_BAKERY_MAILING_WELCOME_EMAIL_FROM
Email sender address for welcome email. The default email sender address is used if not set.
UI_BAKERY_MAILING_WELCOME_EMAIL_FROM_NAME
Email sender name for welcome email. The default email sender name is used if not set.
UI_BAKERY_MAILING_CONFIRM_EMAIL_CHANGE_SUBJECT
Subject for email change email. Default value is Change email request.
UI_BAKERY_MAILING_CONFIRM_EMAIL_CHANGE_TEMPLATE
Can be HTML string or SendGrid email template ID. Supported variables: {{userName}}, {{userEmail}} and {{changeEmailUrl}}.
UI_BAKERY_MAILING_RESET_PASSWORD_SUBJECT
Subject for password reset email. Default value is Reset password request.
UI_BAKERY_MAILING_RESET_PASSWORD_TEMPLATE
Can be HTML string or SendGrid email template ID. Supported variables: {{userName}}, {{userEmail}} and {{resetPasswordUrl}}.
UI_BAKERY_MAILING_SHARE_WITH_USER_SUBJECT
Subject for inviting user email. Default value is You are invited to UI Bakery workspace.
UI_BAKERY_MAILING_SHARE_WITH_USER_TEMPLATE
Can be an HTML string or SendGrid email template ID. Supported variables: {{userName}}, {{userEmail}}, {{organizationUrl}} and {{organizationName}}.
UI_BAKERY_MAILING_REQUEST_TO_JOIN_SUBJECT
Subject for the request to join email. Default value is User would like to join your organization.
UI_BAKERY_MAILING_REQUEST_TO_JOIN_TEMPLATE
Can be an HTML string or SendGrid email template ID. Supported variables: {{userName}}, {{userEmail}}
UI_BAKERY_MAILING_AUTOMATION_ERROR_SUBJECT
Supported variables: {{workflowName}}
UI_BAKERY_MAILING_AUTOMATION_ERROR_TEMPLATE
Can be an HTML string or SendGrid email template ID. Supported variables: {{errorMessage}}, {{workflowName}}

Automations

Environment variable name
Description
UI_BAKERY_RUN_AUTOMATION_IN_SECURE_CONTEXT
In Automations, the execution of code actions should occur within a secure sandbox environment that does not have access to server APIs. This behavior is set to the default value of true.
UI_BAKERY_AUTOMATION_TIMEOUT
the timeout for the automation execution; the default timeout is =90000
UI_BAKERY_AUTOMATION_CODE_EXECUTION_TIMEOUT
the default timeout for JS execution in an automation; the default timeout is =30000

Audit logs

Environment variable name
Description
UI_BAKERY_AUDIT_LOGS_BUFFER_TIME
How long to collect logs before logging them
UI_BAKERY_AUDIT_LOGS_BUFFER_SIZE
How many logs to collect before logging them
UI_BAKERY_AUDIT_LOGS_LOG_PAYLOAD
Store requests payload