Formbricks One-Click setup already comes with a valid SSL certificate using Let’s Encrypt. This guide is only if you already have a valid SSL certificate that you need to use due to company policy or other requirements.

Formbricks’ One-Click setup automatically creates an SSL certificate using Let’s Encrypt. However, some setups need a custom SSL certificate. This is common for intranets or systems with special certificate rules that use an internal or custom certificate authority (CA).

Step 1: Navigate to the Formbricks Folder

Move into the formbricks/ directory:

cd formbricks

Step 2: Create a Folder for SSL Certificates

Create a folder called certs and place your SSL certificate files inside:

mkdir certs
# Move your SSL certificate files to the certs folder
mv /path/to/your/fullchain.crt certs/
mv /path/to/your/cert.key certs/

Step 3: Understand SSL Certificate Files

  • fullchain.crt – Your SSL certificate, including the full certificate chain.

  • cert.key – The private key used to encrypt data.

Step 4: Set Correct File Permissions

Ensure the certificate files have the right permissions:

sudo chown root:root certs/*
sudo chmod 600 certs/*

Step 5: Update traefik.yaml

Modify the file to define HTTP and HTTPS settings:

Step 6: Create certs-traefik.yaml

Create a certs-traefik.yaml file that specifies the path to your custom SSL certificate and key.

Step 7: Update docker-compose.yml

Modify the configuration to enforce SSL. The rest of the configuration should remain the same as the One-Click setup:

Summary

  • Navigate to the Formbricks folder

  • Create a certs/ folder and move your certificate files inside.

  • Ensure you have the correct certificate files (fullchain.crt and cert.key).

  • Update file permissions for security.

  • Modify traefik.yaml to handle HTTPS.

  • Create certs-traefik.yaml to point to your certificate files.

  • Update docker-compose.yml to use your custom SSL certificate.

This setup ensures that Formbricks securely communicates using your own SSL certificate. 🚀

If you have any questions or require help, feel free to reach out to us on GitHub Discussions. 😃