Table of Contents

Installing libssl

TruffleRuby provides the openssl gem but not the native libssl system library that the gem uses. TruffleRuby supports libssl versions 1.0.2, 1.1.0 and 3.0.0.

If you experience openssl-related errors, it might help to recompile the openssl gem by running lib/truffle/ This is done automatically by Ruby managers.

To compile TruffleRuby against a non-system libssl, set OPENSSL_PREFIX while installing TruffleRuby:

export OPENSSL_PREFIX=/path/to/my/openssl-1.1.0

Fedora-based: RHEL, Oracle Linux, etc

sudo dnf install openssl-devel

Debian-based: Ubuntu, etc

sudo apt-get install libssl-dev


On macOS the system version is too old.


We recommend installing libssl via Homebrew.

brew install openssl


MacPorts should also work but is not actively tested.

sudo port install openssl