Install transcrypt

October 8, 2024 ยท View on GitHub

The requirements to run transcrypt are minimal:

  • Bash
  • Git
  • OpenSSL
  • column command (on Ubuntu/Debian install bsdmainutils)
  • if using OpenSSL 3+ one of: xxd (on Ubuntu/Debian is included with vim) or printf command (with %b directive) or perl

...and optionally:

  • GnuPG - for secure configuration import/export

You also need access to the transcrypt script itself...

Manual Installation

You can add transcrypt directly to your repository, or just put it somewhere in your $PATH:

$ git clone https://github.com/elasticdog/transcrypt.git
$ cd transcrypt/
$ sudo ln -s ${PWD}/transcrypt /usr/local/bin/transcrypt

Installation via Packages

A number of packages are available for installing transcrypt directly on your system via its native package manager. Some of these packages also include man page documentation as well as shell auto-completion scripts.

Arch Linux

If you're on Arch Linux, you can build/install transcrypt using the provided PKGBUILD:

$ git clone https://github.com/elasticdog/transcrypt.git
$ cd transcrypt/contrib/packaging/pacman/
$ makepkg -sic

Heroku

If you're running software on Heroku, you can integrate transcrypt into your slug compilation phase by using the transcrypt buildpack, developed by Colin Curtin.

NixOS

If you're on NixOS, you can install transcrypt directly via Nix:

$ nix-env -iA nixos.gitAndTools.transcrypt

Note: The transcrypt derivation was added in Oct 2015, so it is not available on the 15.09 channel.

OS X

If you're on OS X, you can install transcrypt directly via Homebrew:

$ brew install transcrypt

FreeBSD

If you're on FreeBSD, you can install transcrypt directly via the Ports collection:

# `cd /usr/ports/security/transcrypt && make install clean distclean`

or via the packages system:

# `pkg install -y security/transcrypt`