# Gruff Startup Error: OpenSSL Library Not Found

Gruff cannot display itself in this browser because it could not find and/or load compatible OpenSSL libraries. SSL is required for communicating between Gruff and the browser.

# Table of Contents

Compatible OpenSSL versions: 1.0.x, 1.1.x and 3.0.x. See the appropriate section below for more information.

- Windows
- macOS
- Linux
- Support

## Windows

Microsoft does not provide a compatible version of OpenSSL, but our Windows installation package includes OpenSSL libraries, so you should not be seeing this error message. Either they are damaged or have been removed, perhaps by an antivirus service running on your system.

Please check that the following files exists in the Gruff installation directory:

    libcrypto-1_1-x64.dll \__ OpenSSL libraries
    libssl-1_1-x64.dll    /
    aclissl11.dll         => glue library between Gruff and OpenSSL

If any of these files do not exist, then you need to reinstall Gruff, or if only OpenSSL is missing, then install it. We provide a build of OpenSSL which should work on all supported Windows versions.

## macOS

Apple does not provide compatible a version of OpenSSL. but our macOS installation package includes OpenSSL libraries, so you should not be seeing this error message. Either they are damaged or have been removed.

Please check that the following files exists in the Gruff installation directory:

    libcrypto.1.1.dylib \__ OpenSSL libraries
    libssl.1.1.dylib    /
    aclissl11.dylib     => glue library between Gruff and OpenSSL

If any of these files do not exist, then you need to reinstall Gruff, or if only OpenSSL is missing, then install it. If you prefer, OpenSSL can be installed with Brew or MacPorts, and we can recommend both.

For this problem, we recommend running Gruff from a `Terminal` so that you can capture any error messages. You can also look in the file `$HOME/.Gruffapp.log`. It might contain information on the failure startup of Gruff.

## Linux

On Linux, OpenSSL is provided by your Linux distribution. We recommend installing OpenSSL 1.1, but version 1.0 or 3.0 will also work.

NOTE: on many systems, there are two packages which must be installed for Gruff to work properly: `openssl` and `openssl-devel`. The `-devel` package is the one which contains the libraries we load at startup. Those are the names on RHEL/CentOS 7. The names might be different on the flavor of Linux you are using. Please consult the distribution documentation for installing OpenSSL and its libraries.

## Support

If you are unable to get Gruff working, please contact us at support@franz.com.