Gruff Startup Error: OpenSSL Library Not Found

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

See the appropriate section below for more information.

Windows

Microsoft does not provide a version of OpenSSL that Gruff can use, but our Windows installation package includes OpenSSL libraries and 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:

libeay32.dll  \__ OpenSSL libraries
ssleay32.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 binaries.

macOS

Apple does not provide a version of OpenSSL that Gruff can use, but our macOS installation package includes OpenSSL libraries and 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    /
libz.1.dylib        -> library needed by OpenSSL
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. 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 Gruff does work with OpenSSL 1.0, if that is all that is available.

NOTE: on many systems, there are two packages which must be installed for Gruff to work properly: openssl and openssl-devel. Those are the names on RHEL/CentOS 7. The names might be different on the flavor of Linux you are using. Please consult the operating system documentation for installing OpenSSL and its libraries.

Support

If you cannot get Gruff to work, please contact us at support@franz.com.