CrateDB on Red Hat, SUSE, and Derivates

Install CrateDB RPM packages using the DNF, YUM, or ZYpp package managers.

This installation method is suitable for RedHat Enterprise Linux (RHEL) and compatible systems like Fedora, CentOS, Rocky Linux, AlmaLinux, AWS Linux, Oracle Linux, or Scientific Linux. Installation also works on openSUSE and SUSE Linux Enterprise Server (SLES) systems.

Configure package repository

To register with the CrateDB package repository, create a file called cratedb.repo in the /etc/yum.repos.d/ directory for RedHat based distributions, or in the /etc/zypp/repos.d/ directory for OpenSuSE based distributions, containing:

name=CrateDB RPM package repository - $basearch - Stable

name=CrateDB RPM package repository - $basearch - Testing


The configured repository is disabled by default. This eliminates the possibility of accidentally upgrading CrateDB when upgrading the rest of the system. Each install or upgrade command must explicitly enable the repository as indicated in the sample installation command below.

CrateDB provides both stable release and testing release channels. You can read more about the release workflow.

Install CrateDB

With everything set up, you can install CrateDB:

sudo dnf install --enablerepo=cratedb-ce-stable crate


On older Red Hat and CentOS installations, please use the yum command instead of dnf. On SUSE based installations, please use the zypper command.

Configure CrateDB

Please visit the Configuration Settings documentation section to learn about the location and meaning of CrateDB’s configuration files.

Trust signing key

In order to trust the package signing key upfront, before being prompted to do it on the first installation of CrateDB, you can also import it into your repository keyring, like that:

# Install prerequisites.
yum install sudo

# Import the public GPG key for verifying the package signatures.
sudo rpm --import

Control CrateDB on Linux

You can control the crate service with the systemctl utility program:

sudo systemctl COMMAND crate

Replace COMMAND with start, stop, restart, status and so on.


After the installation is finished, the crate service should be installed, but may not be configured to start automatically. Use the following command to start CrateDB:

sudo systemctl start crate

In order to make the service reboot-safe, invoke:

sudo systemctl enable crate

Post-install notes

After successfully installing CrateDB, for example on your workstation, the web-based Admin UI can be visited at:


See also

If you are new to CrateDB, you may want to follow up by taking the guided tour.

Also, let us outline those information entrypoints as suggestions to explore next:


This kind of installation flavor will let you quickly set up and start a single-node cluster. When adding additional CrateDB nodes, in order to make it form a multi-node cluster, you will need to reset (remove) the cluster state after changing the configuration.


Please make sure to read the General Upgrade Guidelines, and the guidelines about rolling upgrades and full restart upgrades, before upgrading a running cluster.