Install AlloyDB Omni

Select a documentation version:

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.

Before you begin

Before you install AlloyDB Omni, make sure that you meet the following requirements.

Choose a download or installation option

Media Download locations and installation guides Deployment to
Debian image DockerHub (tags)
  • Docker, Podman. You can run these containerization tools as a container in any virtual machine (VM).
UBI Image (Red Hat) Red Hat Ecosystem Catalog
  • Red Hat environment. Run this as a container.

Fulfill hardware and software requirements

Make sure that you meet the following minimum hardware and software requirements:

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.), RHEL 8 or 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.

    Verify that cgroupsv2 is enabled

    To determine whether cgroupsv2 is enabled on your machine, run the following command:

    grep cgroup /proc/filesystems

    If your machine supports cgroupsv2, you see the following output:

    nodev cgroup
nodev cgroupsv2

    If your machine doesn't support cgroupsv2, you see the following output:

    nodev cgroup

    Install a container runtime

    Install a container runtime like Docker or Podman. AlloyDB Omni runs in a container.

    Install AlloyDB Omni using Docker

    Root access isn't required for installing AlloyDB Omni.

    Docker

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

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

      Replace the following variables:

      • NEW_PASSWORD: the password to assign the new container's postgres user after its creation.

      • IMAGE_TAG: use 16.8.0 for the latest Debian image or16.8.0-ubi for the latest UBI image.

    2. Connect to containerized AlloyDB Omni using psql:

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

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

    Podman

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

        podman run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:IMAGE_TAG

      Replace the following variables:

      • NEW_PASSWORD: the password to assign the new container's postgres user after its creation.

      • IMAGE_TAG: use 16.3.0 for the latest Debian image or16.3.0-ubi for the latest UBI image.

    2. Connect to containerized AlloyDB Omni using psql:

      podman 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:

    Docker

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

        docker container stop my-omni

    2. Delete your AlloyDB Omni container named my-omni:

        docker container rm my-omni

    Podman

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

        podman container stop my-omni

    2. Delete your AlloyDB Omni container named my-omni:

        podman 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 page.

    What's next