blackbox

Safely store secrets in a VCS repo using GPG
blackbox logo

BlackBox

A tool for secure collaboration in version control systems.


Usage

  • Run blackbox_postdeploy from the root directory of your repository.
  • Use GPG=gpg2 blackbox_ postdeploy if you're using gpg2 alongside system gpg.

Subversion gotchas

  • BlackBox stores the keyring in /keyrings at the root of the entire repository.
  • To set a specific base for your repo, export BLACKBOX_REPOBASE=/path/to/repo.

Two-phase commit

  • commit makes a local change to the version control system.
  • push sends changes upstream to the version control server.

Using BlackBox with gpg2 installed next to gpg

  • Run every BlackBox command with GPG=gpg2 if you're using gpg2 alongside system gpg.

Submit bugs or ask questions?


Developer Info

  • Get the code: git clone [email protected]:StackExchange/blackbox.git
  • Test your changes: make confidence
  • Submit tests with code changes.

Alternatives





> Visit blackbox Website <