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

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;