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!

Ease setup of SecretStorage in virtualenvs

Project Description

SecretStorage Setup is a small project and command line utility to facilitate the setup of SecretStorage in a virtualenv. It was created primarily to make it easy for developers to use the SecretStorage backend in keyring.



This package should be installed inside a virtualenv:

# I'm using vex to create and activate virtualenv.  You can use whatever tool you are used to.
$ vex -m example
$ pip install SecretStorage-Setup

Status: Missing Dependencies

If you don’t have all the dependencies installed in your system python, you may see something like:

$ ss-setup status
dbus package...not installed for this python
Crypto package...not installed for this python
secretstorage package...not installed for this python

In which case, you should see “Dependencies” below for further help. Additionally, you can run with -v to get more info from the status command:

$ ss-setup status -v
dbus package...not installed for this python
Crypto package...not installed for this python
secretstorage package...not installed for this python
Troubleshooting messages follow:

Linking System Dependencies

Since the SecretStorage dependencies are more easily installed using system tools than installing into a virtualenv, the link command will use symlinks to setup the virtualenv to point to the system packages:

$ ss-setup status
dbus package...needs linking into virtualenv
Crypto package...needs linking into virtualenv
secretstorage package...needs linking into virtualenv

$ ss-setup link
linking successful, run the status command to verify

$ ss-setup status
dbus package...ready
Crypto package...ready
secretstorage package...ready


SecretStorage is dependent on:

Debian/Ubuntu System Python

If you are running a Debian based system, you can install all needed dependencies in your system python(s) as follows:

$ sudo apt-get install python-dbus python-crypto python3-dbus python3-crypto

Manually Installed Python

If you have installed Python to a custom location, then you will need to build dbus and install the packages by hand:

# Assuming you have installed your Python in /opt/python34/ and `python3.4` is linked to the
# Python binary correctly.
$ sudo apt-get install libdbus-1-dev libdbus-glib-1-dev
$ wget
$ tar -xzf dbus-python-1.2.0.tar.gz
$ cd dbus-python-1.2.0
$ PYTHON=python3.4 ./configure --prefix=/opt/python34
$ make
$ sudo make install
$ sudo /opt/python34/bin/pip install pycrypto secretstorage

Issues & Discussion

Please direct questions, comments, bugs, feature requests, etc. to:

Current Status

Currently tested on Ubuntu 14.04 with:

  • Ubuntu Python 2.7
  • Ubuntu Python 3.4.0
  • Manual install Python 3.4.3

Issues and pull requests welcome.


0.1.1 released 2015-04-07

  • fix bug when using Ubuntu Python 2.7

0.1.0 released 2015-04-07

  • initial release
Release History

Release History

This version
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
SecretStorage-Setup-0.1.1.tar.gz (6.3 kB) Copy SHA256 Checksum SHA256 Source Apr 8, 2015

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