Repository Installation Scripts

Citus packages are hosted on packagecloud.io. You can install the packages directly using the packagecloud.io installation scripts. However, we also provide custom installation scripts for convenience. The benefits of using the custom installation scripts are:

  1. The repository URL install.citusdata.com/repos.citusdata.com is used instead of packagecloud.io. These URLs are managed by us, allowing isolation from potential changes to the packagecloud.io URL in the future.

  2. The PostgreSQL repository is automatically installed alongside our packages for ease of use.

  3. Essential programs such as curl, wget, gnupg, and apt-transport-https are installed if not already present, as they are required for installing PostgreSQL and Citus packages.

The Repository Installation Scripts are located in the packaging/gh-pages branch. These files are served using GH Pages, and the GH Pages settings can be found in the settings. The original URL prefix for the files is https://citusdata.github.io/packaging/<file-name>. For example, the URL for deb.sh. install.citusdata.com/repos.citusdata.com is a CNAME record for citusdata.github.io in our DNS settings on Cloudflare. For more information about URL redirection, please refer to the Citus Packaging Web Url Certificates document.

There are 8 scripts in this branch for 4 repositories on packagecloud.io:

  1. community

  2. community-nightlies

  3. enterprise

  4. enterprise-nightlies

These scripts are used to install the corresponding repositories. For example, to install the community repository, run the following command:

For Debian/Ubuntu:

curl https://install.citusdata.com/community/deb.sh | sudo bash

For RHEL/CentOS:

curl https://install.citusdata.com/community/rpm.sh | sudo bash