Skip to main content

A backend for ZODB that stores pickles in a relational database.

Project description

RelStorage is a storage implementation for ZODB that stores pickles in a relational database. PostgreSQL 9.0 and above (performance is best with 9.5 and above), MySQL 5.0.32+ / 5.1.34+, and Oracle 10g and 11g are currently supported. RelStorage replaced the PGStorage project.


  • It is a drop-in replacement for FileStorage and ZEO.

  • There is a simple way to convert FileStorage to RelStorage and back again. You can also convert a RelStorage instance to a different relational database.

  • Designed for high volume sites: multiple ZODB instances can share the same database. This is similar to ZEO, but RelStorage does not require ZEO.

  • According to some tests, RelStorage handles high concurrency better than the standard combination of ZEO and FileStorage.

  • Whereas FileStorage takes longer to start as the database grows due to an in-memory index of all objects, RelStorage starts quickly regardless of database size.

  • Supports undo, packing, and filesystem-based ZODB blobs.

  • Both history-preserving and history-free storage are available.

  • Capable of failover to replicated SQL databases.

  • zodbconvert utility to copy databases.

  • Free, open source (ZPL 2.1)


Documentation including installation instructions is hosted on readthedocs.

The complete changelog is also there.


RelStorage is hosted at GitHub:

Continuous integration

A test suite is run for every push and pull request submitted. Travis CI is used to test on Linux, and AppVeyor runs the builds on Windows.

Builds on Travis CI automatically submit updates to to monitor test coverage.

Likewise, builds on Travis CI will automatically submit updates to to monitor code health (adherence to PEP8, absence of common code smells, etc).

Code Health

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Source Distribution

RelStorage-2.1.0.tar.gz (568.0 kB view hashes)

Uploaded source

Built Distributions

RelStorage-2.1.0-cp36-cp36m-win_amd64.whl (283.4 kB view hashes)

Uploaded cp36

RelStorage-2.1.0-cp36-cp36m-win32.whl (282.0 kB view hashes)

Uploaded cp36

RelStorage-2.1.0-cp35-cp35m-win_amd64.whl (283.4 kB view hashes)

Uploaded cp35

RelStorage-2.1.0-cp35-cp35m-win32.whl (282.0 kB view hashes)

Uploaded cp35

RelStorage-2.1.0-cp34-cp34m-win_amd64.whl (281.3 kB view hashes)

Uploaded cp34

RelStorage-2.1.0-cp34-cp34m-win32.whl (280.5 kB view hashes)

Uploaded cp34

RelStorage-2.1.0-cp27-cp27m-win_amd64.whl (281.3 kB view hashes)

Uploaded cp27

RelStorage-2.1.0-cp27-cp27m-win32.whl (280.5 kB view hashes)

Uploaded cp27

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page