Skip to main content

The Crate Data Shell

Project description

Travis CI Version Documentation Coverage

The CrashDB Shell (aka Crash) is an interactive command-line interface (CLI) tool for interacting with CrateDB.


A screenshot of Crash


Recent versions of Crash require Python 3 (>= 3.4) to run.

Use Crash version 0.23.x if you are running Python 2.7 or 3.3.

Use Crash version 0.16.x if you’re running Python 2.6.


Under normal circumstances, you do not have to manually install Crash.

Crash is bundled with CrateDB so there is typically no need to install it yourself.

If you are able to run the crate command, you should be able to run the crash command (either from the same bin directory, or on your PATH).

The following instructions should only be followed if you specifically want to install Crash separately from CrateDB.

Python Package

Crash is available as a pip package.

To install, run:

$ pip install crash

Now, run it:

$ crash

To update, run:

$ pip install -U crash

If you are not using Python version 3.4 or above, recent version of pip will only install version 0.23.x. This is because newer versions of this package are not compatible with Python 2.7 or 3.3 and below.


Crash is also available as a standalone executable that includes all the necessary dependencies, and can be run as long as Python (>= 3.4) is available on your system.

First, download the executable file:

$ curl -o crash

Then, set the executable bit:

$ chmod +x crash

Now, run it:

$ ./crash

If you would like to run crash from any directory, and without the leading ./, the file has to be in a directory that is on your PATH.

Legacy Versions

For Python 2.7 and 3.3 please download version 0.23.0 from the CDN:

$ curl -o crash

For Python 2.6 please download version 0.16.2 from the CDN:

$ curl -o crash


For usage information and options, run:

$ crash --help


This project is primarily maintained by, but we welcome community contributions!

See the developer docs and the contribution docs for more information.


Looking for more help?

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
crash-0.24.0-py2.py3-none-any.whl (61.2 kB) Copy SHA256 hash SHA256 Wheel py2.py3
crash-0.24.0.tar.gz (52.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page