Installing OpenSSL locally under your username

Overview

OpenSSL is a toolkit for the Transport Layer Security (TLS) and Secure Sockets Layer (SSL) protocols. It is also a general-purpose cryptography library. It is used to secure connections on the server and within your software.

This is already installed on all DreamHost servers. As of Nov 2018, DreamHost runs version OpenSSL 1.0.1f.

Do I need to install my own version?

The version on the server works for the majority of all web applications. However, newer software may require a higher version. For example, Python 3.7.1 requires version 1.0.2 or above. In you wish to use software that requires a higher version, you must install the newer version of OpenSSL locally under your Shell user

Installing OpenSSL

This example installs version 1.1.1.

  1. Visit https://www.openssl.org/source/ and locate the version you wish to download. Right click it and choose 'Copy link address'.
  2. Run 'wget' to download the file.
    [server]$ wget https://www.openssl.org/source/openssl-1.1.1.tar.gz
  3. You should also confirm the file's integrity by downloading the SHA256 file on the same page next to it.
    [server]$ https://www.openssl.org/source/openssl-1.1.1.tar.gz.sha256
  4. Once both files are downloaded, view the checksum to confirm the version you downloaded is safe to use.
    [server]$ sha256sum openssl-1.1.1.tar.gz
    2836875a0f89c03d0fdf483941512613a50cfb421d6fd94b9f41d7279d586a3d  openssl-1.1.1.tar.gz
    [server]$ cat openssl-1.1.1.tar.gz.sha256
    2836875a0f89c03d0fdf483941512613a50cfb421d6fd94b9f41d7279d586a3d
    If they match, proceed with the next step.
  5. Decompress this file.
    [server]$ tar zxvf openssl-1.1.1.tar.gz
  6. Change into the new openssl directory
    [server]$ cd openssl-1.1.1
  7. Configure the file:

    This will configure it to be installed in a directory named 'openssl' under your user. Make sure to change 'username' to your Shell user.

    You can install it anywhere you like, just make sure you DO NOT install it into a directory named 'openssl-1.1.1'. This directory was already created when you decompressed the .tar.gz file. If you configure it to install there, it will fail (since it already exists).

    View the following OpenSSL page for information on configuration options:

    [server]$ ./config --prefix=/home/username/openssl --openssldir=/home/username/openssl no-ssl2
  8. Run make. Once that is finished, run make test:
    [server]$ make
    [server]$ make test
    At the end you should see 'All tests successful'.
  9. Run make install
    [server]$ make install
  10. Change back to your home directory.
    [server]$ cd ~
  11. Add the following lines to your .bash_profile. View 'Creating and editing a file via SSH' for instructions.
    export PATH=$HOME/openssl/bin:$PATH
    export LD_LIBRARY_PATH=$HOME/openssl/lib
  12. Source the .bash_profile
    [server]$ . ~/.bash_profile
  13. Test to confirm it's installed in the correct location and that the version is 1.1.1.
    [server]$ which openssl
    /home/username/openssl/bin/openssl
    [server]$ openssl version
    OpenSSL 1.1.1  11 Sep 2018

OpenSSL has been installed locally under your username.

See also

Did this article answer your questions?

Article last updated PST.