Skip to main content

Easily export your Stormpath user data.

Project description

Easily export your Stormpath user data.

stormpath-export Release stormpath-export Downloads stormpath-export Code Quality stormpath-export Build Box Sketch


Stormpath is one of my favorite API services. They provide a scalable, simple, and secure user management API which makes building scalable systems simple.

Whenever I talk to people about using Stormpath, the same question invariably comes up: “Is it easy to export my user data out of Stormpath? Or am I locked in?”

Up until now, the answer has been “Yes! But only if you contact them about it.”

With stormpath-export, however, you can easily back up all your Stormpath user data instantly!

stormpath-export will:

  • Grab all Stormpath data you’ve stored, and dump it to JSON files locally.
  • Dump data into a local directory structure which makes intuitive sense (groups are located in the groups directory, etc.).
  • Each object gets it’s own JSON file generated. This makes it easy to look at the file system and extract the information you need.

stormpath-export makes it easy to:

  • Download a copy of all your user data.
  • Back up your user data (Stormpath has their own backups of course, but you can never be too safe).
  • Migrate user data out of Stormpath.


Installing stormpath-export is simple – just use pip!

Once you have pip installed on your computer, you can run the following to install the latest release of stormpath-export:

$ pip install -U stormpath-export

That’s it :)


Before you can export all your Stormpath data, you’ll need to configure stormpath-export and give it your Stormpath API credentials. To do this, simply run:

$ stormpath-export configure

This will prompt you for some basic information, then store your credentials in the local file ~/.stormy.

NOTE: If you are using Stormpath Enterprise, please enter when prompted for the Base URL. This instructs the export tool to talk to the Stormpath Enterprise environment.

Next, to initiate a backup job, you can run:

$ stormpath-export

This will export all your Stormpath data, and dump it into a new directory named stormpath-exports. If you’d like to specify your own backup location, you can do so by adding a path – for instance:

$ stormpath-export ~/Desktop/stormpath-exports

When exporting your data, you should see output similar to the following:

=== Exporting all application data...
- Exporting application: Stormpath
=== Done!

=== Exporting all directory data...
- Exporting directory: Stormpath Administrators
- Exporting directory: testdirectory
=== Done!

=== Exporting all group data...
- Exporting group: Administrators
=== Done!

=== Exporting all account data...
- Exporting account:
=== Done!


Depending on how many applications, groups, directories, organizations, and accounts you have, this process may take a while.

Once the process is finished, you can navigate the JSON files in the export directory, which will contain all your Stormpath data.

For full usage information, run stormpath-export -h:

$ stormpath-export -h

Easily export your Stormpath ( user data.

  stormpath-export configure
  stormpath-export [(<location> | -l <location> | --location <location>)]
  stormpath-export (-h | --help)
  stormpath-export --version

  -h --help  Show this screen.
  --version  Show version.

Written by Randall Degges <>.


Need help? Can’t figure something out? If you think you’ve found a bug, please open an issue on the Github issue tracker.

Otherwise, shoot us an email.


0.1.2: 12-27-2016

  • Importing missing dependency.

0.1.1: 10-17-2016

  • Supporting --base-url argument.
  • Making the tool Python 3 compatible.

0.1.0: 03-16-2016

  • Supporting API key exports.
  • Supporting Organization exports.
  • Fixing documentation.
  • Updating Stormpath dependency.

0.0.9: 06-19-2015

  • Fixing version information.

0.0.8: 06-19-2015

  • Supporting private deployments.

0.0.7: 06-18-2015

  • Supporting Account API key backups.

0.0.6: 06-18-2015

  • Completely re-doing export structures – much more sane now.
  • Adding IDs, hrefs, and all fields to all backups.
  • Still needs to support Social / ID site / Verification templates.

0.0.5: 05-28-2015

  • Making the application export back up directory mappings.

0.0.4: 05-27-2015

  • Backing up customData for all resource types.
  • Upgrading dependencies.

0.0.3: 06-19-2014

  • Making application export include directory name for clarity.

0.0.2: 06-08-2014

  • Fixing bug with groups.
  • Adding support for custom data exporting.
  • Including new Stormpath SDK.

0.0.1: 12-14-2013

  • First super-beta release of the project. WOO.

Project details

Download files

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

Files for stormpath-export, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size stormpath_export-0.1.2-py2.py3-none-any.whl (11.5 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size stormpath-export-0.1.2.tar.gz (11.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page