Run CrateDB on Debian GNU/Linux

CrateDB actively maintains packages for the following Debian versions:


Packages for distributions marked as legacy are not actively maintained and no longer receive updates.

This document will walk you through the process of installing and configuring the CrateDB Debian package.


This document targets production deployments.

If you’re just getting started with CrateDB, we also provide a one-step Linux installer .

Table of contents

Configure Apt

Firstly, you will need to upgrade Apt (the Debian package manager) with HTTPS support, like so:

sh$ sudo apt-get install apt-transport-https

After that, you will need to download the CrateDB GPG key:

sh$ wget

And then, so that Apt trusts the CrateDB repository, add the key:

sh$ sudo apt-key add DEB-GPG-KEY-crate

CrateDB provides a stable and a testing release channel. At this point, you should select which one you wish to use.

Create an Apt configuration file, like so:

sh$ sudo touch /etc/apt/sources.list.d/crate-CHANNEL.list

Here, replace CHANNEL with stable or testing, depending on which release channel you plan to use.

Then, edit it, and add the following:

deb CODENAME main
deb-src CODENAME main

Here, replace CHANNEL as above, and then, additionally, replace CODENAME with the codename of your distribution (e.g., buster, stretch, jessie, or wheezy)

Once that is done, update Apt:

sh$ sudo apt-get update

You should see a success message. This indicates that the CrateDB release channel is correctly configured and the crate package has been registered locally.

Install CrateDB

With everything set up, you can install CrateDB, like so:

sh$ sudo apt-get install crate

After the installation is finished, the crate service should be up-and-running.

You should be able to access it by visiting:


See also

If you’re new to CrateDB, check out our our first use documentation.

Controlling CrateDB

With Debian Jessie (8.x) and above, you can control the crate service like so:

sh$ sudo systemctl COMMAND crate

Here, replace COMMAND with start, stop, restart, status and so on.


Be sure to read the guide to rolling upgrades and full restart upgrades before attempting to upgrade a running cluster.


Configuration files

The main CrateDB configuration files are located in the /etc/crate directory.


The CrateDB startup script sources environment variables from the /etc/default/crate file.

Here’s one example:

# Heap Size (defaults to 256m min, 1g max)

# Maximum number of open files, defaults to 65535.

# Maximum locked memory size. Set to "unlimited" if you use the
# bootstrap.mlockall option in crate.yml. You must also set

# Additional Java OPTS

# Force the JVM to use IPv4 stack

Customized setups

A full list of package files can be obtained with this command:

sh$ dpkg-query -L crate

If you want to deviate from the way that the crate package integrates with your system, we recommend that you go with a basic tarball installation.


How helpful was this page?