Troubleshooting

This document contains solutions for known problems when running Retool on supported operating systems.

Windows Ubuntu

SSL: CERTIFICATE_VERIFY_FAILED error

If you see the error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate when trying to download files in Retool, it means that Python's SSL module doesn't have access to the certificates it needs on your local machine to verify that it can trust the secure website it wants to download from.

The easiest way to work around this is to install OpenSSL and import the Mozilla CA certificate store:

1. Download OpenSSL (the light version is fine), and then run the installer.

   Note

   You might be prompted to download and install a Visual C++ redistributable as part of the OpenSSL installation process. Do so. The redistributable downloads to your default download directory, and you should install it before continuing the OpenSSL installation.

2. Complete the OpenSSL install.

3. Open Windows PowerShell as an administrator.

4. Run the following script to download and import the Mozilla CA certificate store:

   cd $env:USERPROFILE;
   Invoke-WebRequest https://curl.se/ca/cacert.pem -OutFile $env:USERPROFILE\cacert.pem;
   $plaintext_pw = 'PASSWORD';
   $secure_pw = ConvertTo-SecureString $plaintext_pw -AsPlainText -Force;
   & 'C:\Program Files\OpenSSL-Win64\bin\openssl.exe' pkcs12 -export -nokeys -out certs.pfx -in cacert.pem -passout pass:$plaintext_pw;
   Import-PfxCertificate -Password $secure_pw  -CertStoreLocation Cert:\LocalMachine\Root -FilePath certs.pfx;
   

Retool should now be able to download the files it needs.

libxcb error

If you get a libxcb error in Linux when launching retoolgui in Ubuntu, you might need to download the following libraries:

sudo apt-get install libxcb-randr0-dev \
        libxcb-xtest0-dev libxcb-xinerama0-dev libxcb-shape0-dev libxcb-xkb-dev