Skip to main content
A fresh instance runs with sensible defaults. Everything below is optional, and most of it is a matter of adding environment variables and restarting your containers.
Almost every setting on this page is an environment variable. Environment Variables is the full list, and the page to read first.

Getting mail out

Formbricks sends verification mail, invitations, email follow-ups and email surveys. None of that works until you point the instance at an SMTP server.

SMTP

Point Formbricks at a mail server.

Job Runner

Run the background worker that sends the mail and processes queued work.

Reaching your instance

Where Formbricks lives on the network, and how browsers get to it.

Domain Configuration

Set the public-facing URL your instance answers on.

Custom SSL Certificate

Bring your own certificate to the One-Click setup.

Custom Subpath

Serve Formbricks under a path prefix instead of a domain root.

CDN

Cache public traffic without serving stale survey assets after an upgrade.

Storing what people upload

File Uploads

Configure storage for survey images, file-upload answers and workspace assets.

Signing in

Out of the box people sign in with an email address and a password. Point the instance at your own identity provider instead and sign-in follows the rules you already enforce there.
Single Sign-On is part of the Enterprise Edition — every provider below, not only SAML. SAML additionally needs the saml entitlement on the licence.

Authentication Behavior

Who may sign up, and whether an invitation is required.

Open ID Connect

The generic OIDC setup. Start here if your provider is not listed separately.

Keycloak OIDC

OIDC against a Keycloak realm.

Azure AD OAuth

Microsoft Entra ID, formerly Azure AD.

Google OAuth

Google Workspace accounts.

SAML SSO

SAML 2.0, for providers that do not speak OIDC.

Connecting third-party tools

Airtable, Google Sheets, Notion and Slack each need an OAuth app you register with the service, and its credentials as environment variables. n8n, Zapier and ActivePieces connect the other way round, through a Formbricks API key, and need no server configuration at all. Still struggling or something not working as expected? Join our GitHub Discussions and we’d be glad to assist you!