Secret Pass

Central Collection Point

To store the access data with the use of Git on a central host on the local network, the VCS must be installed there. If you use a preconfigured network-attached storage (NAS), look for the software in the NAS's package manager. One alternative is the use of an energy-saving Raspberry Pi for this task. With a minimal system, for example based on Raspbian Lite, you have an ideal computer as a remote station.

The host should preferably support login via Secure Shell. A separate article in this issue explains how to set up such a login and then configure SSH so that it suits your daily work schedule as effectively as possible.

In the following example, I assume you are running a Raspberry Pi as a NAS on the local network with hostname storage. Now create the repository in the home directory of user pi. To do this, switch to the host (e.g., by SSH) and create a new repository first. The first command from Listing 2 creates a simple directory, and the second then initializes the repository.

Listing 2

Creating a Repository

$ mkdir -p repos/password-store
$ git --bare init repos/password-store

Use the --bare option to tell Git that this is not a working directory, but one where you can add commits or retrieve changes. This setup has the practical effect that the files that Git needs for administration are located directly in the folder, instead of in a hidden .git directory below it.

To use the new central repository in the password manager, first make sure that the data in .password-store/ is under Git's control. You do this by typing pass git init in a terminal. The VCS outputs the typical status messages.

The structure of the commands is basically always the same: You use Git's regular syntax but always prefix it with the program name pass. This allows you to take full advantage of Git's features without much more configuration (see the "Tip" box).

Once you have initialized the local repository, add a remote repository with which you can exchange data. You do this with the commands from Listing 3.

Listing 3

Adding a Remote Repository

$ pass git init
$ pass git remote add origin pi@storage:repos/password-store
$ pass git push

When adding an external repository, first assign a name (origin in the example) and append the appropriate URL to it. You can freely assign the name; origin has just established itself as a convention. Finally, use the last command from Listing 3 to synchronize the remote target with the dataset from the local repository.

If you have also placed the local files on other computers under Git's control, you just need to configure the central computer as a host to integrate the respective files, as well.

If you want to retrieve the data from the central computer, simply type pass git pull. You will then find the same encrypted files on the host in question as on the central computer. In other words, if you want to work with files from different computers, this system makes synchronization easy. However, it remains your responsibility to keep the GnuPG keys consistent across all hosts.


The Pass password manager lets you store as many different passwords as you like for different accounts, and you'll still only need one password to decrypt them all. Although the technology behind Pass is relatively simple – after all, it's just a shell script – the combination of mature components adds to the overall effect.

Git lets you synchronize different hosts via a shared repository: It should go without saying that a public repository is not suitable for storing passwords.


Make sure you don't forget the git parameter; otherwise, Pass will attempt to reinitialize the password memory.


  1. Pass:
  2. GnuPG:
  3. "Unison: Data transfer" by Erik Bärwaldt, Ubuntu User, issue 8, 2011, p. 64
  4. Git: http://http//

Buy this article as PDF

Express-Checkout as PDF
Price $2.95
(incl. VAT)

Buy Linux Magazine

Get it on Google Play

US / Canada

Get it on Google Play

UK / Australia

Related content

comments powered by Disqus
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters

Support Our Work

Linux Magazine content is made possible with support from readers like you. Please consider contributing when you’ve found an article to be beneficial.

Learn More