Skip to content

Installing Themis

Karen Sawrey edited this page May 17, 2019 · 11 revisions

Installing Themis

The easiest way to install Themis is to use package repositories. Themis Core library can be installed into your system from Cossack Labs repositories. High-level language wrappers can be installed from language-specific repositories.

Most language wrappers (except mobile) require the core Themis library to be installed in the system. Make sure to install the core library and its dependencies before installing language wrappers.

Package repositories contain stable versions of Themis, prebuilt and packaged for the most widely-used systems. If you need the latest development version of Themis or your system is not supported yet, you can build and install Themis from GitHub source code.

Installing Themis Core

The core library is available via Cossack Labs package repositories. Please follow the instructions below for your operating system.

Debian, Ubuntu

Supported systems:

  • Debian 8 "Jessie"
  • Debian 9 "Stretch"
  • Ubuntu 14.04 LTS "Trusty Tahr"
  • Ubuntu 16.04 LTS "Xenial Xerus"
  • Ubuntu 18.04 LTS "Bionic Beaver"

1. Import Cossack Labs public key

You need to import the public key used by Cossack Labs to sign packages:

wget -qO - https://pkgs.cossacklabs.com/gpg | sudo apt-key add -

NOTE: If you wish to validate the key fingerprint, it is:
29CF C579 AD90 8838 3E37 A8FA CE53 BCCA C8FF FACB

2. Make sure APT supports HTTPS

You should install HTTPS support for APT if it is not installed already:

sudo apt-get install apt-transport-https

3. Add Cossack Labs repository to your sources.list

Create a new *.list file under /etc/apt/sources.list.d directory (for example, /etc/apt/sources.list.d/cossacklabs.list). Put the following line into the list file:

deb https://pkgs.cossacklabs.com/stable/$OS_NAME $RELEASE main

where

  • $OS_NAME should be debian or ubuntu
  • $RELEASE should be Debian or Ubuntu release name (like stretch). You can determine this by running lsb_release -cs, if you have lsb_release installed.

We currently build packages for the following OS_NAME and RELEASE combinations:

  • debian jessie — Debian 8 "Jessie",
  • debian stretch — Debian 9 "Stretch",
  • ubuntu trusty — Ubuntu 14.04 LTS "Trusty Tahr",
  • ubuntu xenial — Ubuntu 16.04 LTS "Xenial Xerus",
  • ubuntu bionic — Ubuntu 18.04 LTS "Bionic Beaver".

For example, if you are running Debian 9 "Stretch", run:

echo "deb https://pkgs.cossacklabs.com/stable/debian stretch main" | \
  sudo tee /etc/apt/sources.list.d/cossacklabs.list

4. Reload local package database

sudo apt-get update

5. Install Themis package

sudo apt-get install libthemis

CentOS, RHEL, OEL

Supported systems:

  • CentOS 7

NOTE: We build RPM packages only for x86_64, 32-bit systems are not supported.

1. Import Cossack Labs public key

You need to import the public key used by Cossack Labs to sign packages:

sudo rpm --import https://pkgs.cossacklabs.com/gpg

NOTE: If you wish to validate the key fingerprint, it is:
29CF C579 AD90 8838 3E37 A8FA CE53 BCCA C8FF FACB

2. Add Yum repository for Cossack Labs

The easiest way is to download the *.repo file from our server:

wget -qO - https://pkgs.cossacklabs.com/stable/centos/cossacklabs.repo | \
  sudo tee /etc/yum.repos.d/cossacklabs.repo

3. Install Themis package

sudo yum install libthemis

macOS

Themis is available on macOS via Homebrew.

Supported systems:

  • macOS 10.12 Sierra,
  • macOS 10.13 High Sierra,
  • macOS 10.14 Mojave.

1. Add Cossack Labs tap

brew tap cossacklabs/tap

2. Update local formula database

brew update

3. Install Themis

brew install libthemis

Installing Themis wrappers

Installing language-specific wrappers is done after you've installed the core library itself. Please check out the corresponding language guides for more details on how to install Themis wrapper for your language:

Clone this wiki locally
You can’t perform that action at this time.