Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Encrypted plaintext password store

Project Description

Sala lets you store passwords and other bits of sensitive plain-text information to encrypted files on a directory hierarchy. The information is protected by GnuPG’s symmetrical encryption.

Basic usage

Passwords are stored in a directory hierarchy, each file containing one secret.


sala init
Initialize a password store
sala get FILE...
Read secret(s)
sala set FILE...
Create or modify secret(s)
sala FILE...
Read or modify, depending on whether the first file exists or not

For more information, see sala(1) and


Install sala by invoking:

pip install sala

To install from source, invoke:

python install


Suggested packages:

  • pwgen: With the default configuration, if pwgen is installed, it’s used to suggest good passwords to the user


The test suite is in the test/ directory. Use the script to run the test suite. For more info, invoke:

python --help

cram 0.5 or newer is required to run the tests. If coverage is installed, the script can also show test coverage.

The documentation is in the doc/ directory. To build a manpage and a HTML documentation page, invoke

make -C doc

in the top directory. Docutils 0.8 or newer is required.

Release history

Version 1.3

Released on 2012-06-13

  • Respect SALADIR when creating subdirectories with ‘set’.
  • Add a bash completion script: contrib/sala-completion.bash.
  • Move the repository state to the .sala subdirectory. .salakey becomes .sala/key and sala.conf becomes .sala/config.
  • Add support for hooks in .sala/hooks. Initially, the post-set hook is supported.

Version 1.2

Released on 2011-12-31

  • Add -r option for raw output format.
  • Allow setting the store location with SALADIR environment variable and -C command line option.
  • Add support for Python 3.2, drop support for Python 2.5.
  • Drop the GnuPGInterface dependency. Sala now implements its own GnuPG wrapper.
  • Add man page (in ReST format), move most of README there.
  • Improve portability.
  • Add a regression test suite (cram is required to run the tests).

Version 1.1

Released on 2011-02-02

  • Add support for Python 2.5.
  • Read configuration from $XDG_CONFIG_HOME/sala.conf, too.

Version 1.0.1

Released on 2011-01-19

  • Distribute README.rst, LICENSE and CHANGES with the source tarball.

Version 1.0

Released on 2011-01-18

  • Initial release.
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
sala-1.3.tar.gz (16.9 kB) Copy SHA256 Checksum SHA256 Source Jun 13, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting