Select a documentation version: <button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">15.5.2</button>

- [Current (18.4.0)](https://docs.cloud.google.com/alloydb/omni/containers/current/docs/quickstart.md.txt)
- [18.4.0](https://docs.cloud.google.com/alloydb/omni/containers/18.4.0/docs/quickstart.md.txt)
- [18.3.0](https://docs.cloud.google.com/alloydb/omni/containers/18.3.0/docs/quickstart.md.txt)
- [18.1.0](https://docs.cloud.google.com/alloydb/omni/containers/18.1.0/docs/quickstart.md.txt)
- [17.10.0](https://docs.cloud.google.com/alloydb/omni/containers/17.10.0/docs/quickstart.md.txt)
- [17.9.0](https://docs.cloud.google.com/alloydb/omni/containers/17.9.0/docs/quickstart.md.txt)
- [17.7.0](https://docs.cloud.google.com/alloydb/omni/containers/17.7.0/docs/quickstart.md.txt)
- [17.5.0](https://docs.cloud.google.com/alloydb/omni/containers/17.5.0/docs/quickstart.md.txt)
- [16.14.0](https://docs.cloud.google.com/alloydb/omni/containers/16.14.0/docs/quickstart.md.txt)
- [16.13.0](https://docs.cloud.google.com/alloydb/omni/containers/16.13.0/docs/quickstart.md.txt)
- [16.11.0](https://docs.cloud.google.com/alloydb/omni/containers/16.11.0/docs/quickstart.md.txt)
- [16.9.0](https://docs.cloud.google.com/alloydb/omni/containers/16.9.0/docs/quickstart.md.txt)
- [16.8.0](https://docs.cloud.google.com/alloydb/omni/containers/16.8.0/docs/quickstart.md.txt)
- [16.3.0](https://docs.cloud.google.com/alloydb/omni/containers/16.3.0/docs/quickstart.md.txt)
- [15.18.0](https://docs.cloud.google.com/alloydb/omni/containers/15.18.0/docs/quickstart.md.txt)
- [15.17.0](https://docs.cloud.google.com/alloydb/omni/containers/15.17.0/docs/quickstart.md.txt)
- [15.15.0](https://docs.cloud.google.com/alloydb/omni/containers/15.15.0/docs/quickstart.md.txt)
- [15.13.0](https://docs.cloud.google.com/alloydb/omni/containers/15.13.0/docs/quickstart.md.txt)
- [15.12.0](https://docs.cloud.google.com/alloydb/omni/containers/15.12.0/docs/quickstart.md.txt)
- [15.7.1](https://docs.cloud.google.com/alloydb/omni/containers/15.7.1/docs/quickstart.md.txt)
- [15.7.0](https://docs.cloud.google.com/alloydb/omni/containers/15.7.0/docs/quickstart.md.txt)
- [15.5.5](https://docs.cloud.google.com/alloydb/omni/containers/15.5.5/docs/quickstart.md.txt)
- [15.5.4](https://docs.cloud.google.com/alloydb/omni/containers/15.5.4/docs/quickstart.md.txt)
- [15.5.2](https://docs.cloud.google.com/alloydb/omni/containers/15.5.2/docs/quickstart.md.txt)

<br />

> [!NOTE]
> **Note:** Your use of AlloyDB Omni is subject to the agreement between you and Google that governs Google Cloud offerings. If you do not have a Google Cloud account, or have not otherwise entered into an agreement with Google that governs Google Cloud offerings, please do not proceed or download this software until you have done so. To create a Google Cloud account, see [the Google Cloud homepage](https://docs.cloud.google.com/docs/get-started).

<br />

This quickstart shows you how to install AlloyDB Omni on your own
environment in a few steps.

- To install a production-ready AlloyDB Omni cluster in a Linux environment, see [Install
  AlloyDB Omni on Debian or Ubuntu](https://docs.cloud.google.com/alloydb/omni/containers/15.5.2/docs/quickstart#linux).

## Install AlloyDB Omni on Debian or Ubuntu

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.

1. Install the AlloyDB Omni CLI and Docker on your Debian or Ubuntu machine:

   ```bash
     curl https://us-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add -
     sudo apt update
     echo "deb https://us-apt.pkg.dev/projects/alloydb-omni alloydb-omni-apt main" \
     | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
     sudo apt update
     sudo apt-get -y install alloydb-cli docker.io
   ```
2. Use the command-line program to install and launch the AlloyDB Omni
   server software:

   ```bash
   sudo alloydb database-server install
   ```
3. Connect to AlloyDB Omni using `psql`:

   ```bash
   sudo docker exec -it pg-service psql -h localhost -U postgres
   ```

   The terminal window displays `psql` login text that ends with a
   `postgres=#` prompt.

## What's next

- [Run and connect to
  AlloyDB Omni](https://docs.cloud.google.com/alloydb/omni/containers/15.5.2/docs/run-connect)

- [Customize your AlloyDB Omni installation](https://docs.cloud.google.com/alloydb/omni/containers/15.5.2/docs/install.md.txt)