First use

Once CrateDB is installed and running, you can start to interact with the database for the first time.

Table of contents

Introducing the Admin UI

CrateDB ships with a browser-based administration interface called Admin UI.

The CrateDB Admin UI runs on every CrateDB node, and you can use it to inspect and interact with the whole CrateDB cluster in a number of ways.

We will use the Admin UI throughout this section.

Access the Admin UI in your browser using a URL like this:


If CrateDB is not running locally, replace localhost with the hostname CrateDB is running on.

You should see something like this:


Introducing the CrateDB Shell

The CrateDB Shell (aka Crash) is an interactive command-line interface (CLI) program for working with CrateDB on your favorite terminal. For further information about it, please follow up on its documentation at The CrateDB Shell.


If you are running CrateDB on a remote machine, you will have to create a dedicated user account for accessing the Admin UI. See Create user.

Follow more tutorials to get a sense of CrateDB

If you want to get a feel for using CrateDB to work with time series data, you are going to need a source of time series data. Fortunately, there are many ways to generate time series data by sampling the systems running on your local computer.

The next collection of tutorials shows how to generate mock time series data about the International Space Station (ISS) and write it to CrateDB using the client of your choice.

Start building with CrateDB clients and tools

If you’d like to skip the tutorials and start building with CrateDB, you can find a list of CrateDB Clients and Tools in a different section of the documentation.

Dive into CrateDB

Check out the CrateDB How-To Guides for goal oriented topics. Alternatively, check out the CrateDB Reference for a complete reference manual.


How helpful was this page?