Troubleshooting

Unknown error during login

When setting up Single Sign-On, you might encounter the general error "Unknown error during login." This issue can stem from various causes. In such instances, the recommended course of action is to check the logs of the bakery-back container. For Docker Compose setups, execute the following commands:

1. Identify and copy the container ID for the bakery-back container using the docker ps command.

2. Display the logs with the command: docker logs CONTAINER_ID

Proxy configuration

If you are utilizing a proxy in your system, requests from the UI Bakery server to your Identity Provider may encounter failures. To resolve this, set the following environment variable to enable the UI Bakery server to use your proxy::

JAVA_OPTS='-Dhttps.proxyHost=local-proxy.default -Dhttps.proxyPort=3128 -Dhttps.proxySet=true'

Hiding email and password inputs

To conceal email and password inputs, utilize the following environment variable:

UI_BAKERY_EMAIL_AUTH_ENABLED=false

Allowing custom emails to join workspace

By default, only users with emails on "example.com" can join the workspace if the Allow auto-sign up with domain.com emails workspace setting is enabled. If you need to allow users with custom emails to join your workspace you can use the UI_BAKERY_SSO_WORKSPACE_CLAIM environment variable.

If you set the variable value to "workspace" and then include the "workspace" claim with the "your workspace URL" value, then during registration the user will be automatically assigned to the specified workspace. For example, UI_BAKERY_SSO_WORKSPACE_CLAIM=myworkspace, where myworkspace=example , example here is equal to your workspace URL in UI Bakery.

Adjusting NGINX for Larger Headers

When using NGINX as a reverse proxy for UI Bakery, you may need to increase the client header buffer. Incorporate the following lines into your NGINX server configuration:

proxy_buffer_size 128k;
proxy_buffers 4 256k;
proxy_busy_buffers_size 256k;

client_header_buffer_size 64k;
large_client_header_buffers 4 64k;