Select a documentation version: <button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">15.5.4</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 that can run
in any UNIX-based environment which supports container runtimes.

For an overview of AlloyDB Omni, see [AlloyDB Omni overview](https://docs.cloud.google.com/alloydb/omni/containers/15.5.4/docs).

## Before you begin

The following table lists minimum hardware and software requirements for AlloyDB Omni.

| OS/Platform | Minimum hardware | Minimum software |
|---|---|---|
| Linux | - x86-64 or Arm (\*) CPU with AVX2 support - 2 GB of RAM - 10 GB of disk space | - Debian based OS (Ubuntu, etc) or RHEL 9 - Linux kernel version 5.3 or higher - Cgroupsv2 enabled - Docker Engine 20.10+ or Podman 4.2.0+ |
| macOS | - Intel CPU with AVX2 support or M-chip - 2GB of RAM - 10 GB of disk space | - Docker Desktop 4.20 or higher |
| (\*) Arm support is in [Preview](https://cloud.google.com/products?e=48754805&#product-launch-stages). |||

AlloyDB Omni runs in a container. Install a container runtime like [Docker](https://docs.docker.com/engine/install/) or [Podman](https://podman.io/docs/installation) on your machine before installing AlloyDB Omni.

## Install AlloyDB Omni using Docker

> [!NOTE]
> **Note:** [Root access](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) is not required for installing AlloyDB Omni.

1. Use the `docker run` command to create a new container with AlloyDB Omni named `my-omni`:

   ```bash
   docker run --name my-omni \
     -e POSTGRES_PASSWORD=NEW_PASSWORD \
     -d google/alloydbomni:15.5.4
   ```

   Replace `NEW_PASSWORD` with a password to assign the new container's `postgres` user after its creation.

> [!NOTE]
> **Note:** By default, AlloyDB Omni stores your data on the container itself, and not on your host file system. The data directory is deleted once you delete your AlloyDB Omni container. To mount a data directory stored on your host file system, see instructions in [Customize your AlloyDB Omni installation](https://docs.cloud.google.com/alloydb/omni/containers/15.5.4/docs/install.md.txt).

1. Connect to containerized AlloyDB Omni using `psql`:

   ```bash
   docker exec -it my-omni psql -h localhost -U postgres
   ```

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

## Clean up

To clean up the AlloyDB Omni container you created during this quickstart, use these steps:

1. Stop your AlloyDB Omni container named `my-omni`:

   ```bash
   docker container stop my-omni
   ```
2. Delete your AlloyDB Omni container named `my-omni`:

   ```bash
   docker container rm my-omni
   ```

For instructions how to install AlloyDB Omni in a new container for production usage, go to the [Customize your AlloyDB Omni installation](https://docs.cloud.google.com/alloydb/omni/containers/15.5.4/docs/install.md.txt) page.

## What's next

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

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

- [Set up your AlloyDB Omni for production](https://docs.cloud.google.com/alloydb/omni/containers/15.5.4/docs/configure-omni.md.txt)