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

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 is not 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:15

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

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

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

    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