This section shows you how to install AlloyDB Omni using the
AlloyDB Omni CLI in your Debian or Ubuntu environment.
System requirements
Ensure that you have a Linux machine that meets the following system
requirements:
A virtual or physical machine running a Debian-based OS, such as
Debian or Ubuntu.
A minimum of 2 CPUs, with x86/AMD64 architecture.
A minimum of 2 GB of RAM. For optimal performance, we recommend
allocating 8 GB of RAM for each CPU.
At least 20 GB of available storage.
Unrestricted root access within the OS.
Linux kernel version 4.18 or higher. We recommend kernel version
5.3 or higher for best performance.
Linux cgroup v2 enabled.
By default, cgroup v2 is enabled on most modern Linux systems.
To check whether cgroup v2 is enabled, run
stat -fc %T /sys/fs/cgroup/ in a shell. If cgroup v2 is
enabled, the command output shows cgroup2fs.
TCP port 5432 not in use by any other service.
If you are installing AlloyDB Omni on a cloud
platform, then we recommend using the following instance types:
On Google Cloud, we recommend n2-highmem instances.
On Amazon Web Services, we recommend R6i instances.
On Microsoft Azure, we recommend Ebsv5 instances.
Install the AlloyDB Omni CLI and Docker on your Debian or Ubuntu machine:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eAlloyDB Omni can be installed on Debian or Ubuntu environments using the AlloyDB Omni CLI, providing a quick setup for your own environment.\u003c/p\u003e\n"],["\u003cp\u003eSystem requirements for running AlloyDB Omni include a Debian-based OS, minimum 2 CPUs, 2 GB RAM (8 GB per CPU recommended), 20 GB storage, and Linux kernel 4.18 or higher.\u003c/p\u003e\n"],["\u003cp\u003eThe installation process involves installing the AlloyDB Omni CLI and Docker, followed by running a command to install and launch the AlloyDB Omni server software.\u003c/p\u003e\n"],["\u003cp\u003eConnecting to AlloyDB Omni is achieved via \u003ccode\u003epsql\u003c/code\u003e after the server software is launched, allowing users to interact with the database using a command-line prompt.\u003c/p\u003e\n"],["\u003cp\u003eFor optimal performance on cloud platforms, specific instance types are recommended, such as \u003ccode\u003en2-highmem\u003c/code\u003e on Google Cloud, \u003ccode\u003eR6i\u003c/code\u003e on Amazon Web Services, and \u003ccode\u003eEbsv5\u003c/code\u003e on Microsoft Azure.\u003c/p\u003e\n"]]],[],null,[]]