Skip to main content
Version: v2.2

DEB package

We provide different .deb packages for various deployments on our release page.

  • For most use cases, we recommend using the production package (e.g., ferretdb.deb).
  • For debugging purposes, use the development package (contains a -dev suffix e.g., ferretdb-dev.deb). It includes features that significantly slow down performance and is not recommended for production use.

Installation​

Download the appropriate FerretDB .deb package from our release page, rename it to ferretdb.deb.

To install the ferretdb.deb package on your Debian, Ubuntu, and other .deb-based systems, you can use dpkg tool, as shown below:

sudo dpkg -i ferretdb.deb

You can check that FerretDB was installed by running:

ferretdb --version

The .deb package ships with the systemd unit for starting FerretDB automatically. For more information about its configuration, please take a look at systemd configuration guide.

FerretDB does not automatically install PostgreSQL and DocumentDB extension, see DocumentDB extension DEB package installation guide.

tip

Ensure to enable telemetry to receive notifications on the latest versions. For more information on the best DocumentDB version to use, see the corresponding release notes for the FerretDB package.

Find out more about:

Updating to a new version​

Before updating to a new FerretDB version, make sure to update to the matching DocumentDB package first. Following the DocumentDB update guide is critical for a successful update.

Download the new .deb package from the release page. Then, install the new package using dpkg:

sudo dpkg -i /path/to/<new-ferretdb-package>.deb

Then verify that the new version is installed by running:

ferretdb --version