Console
    Contact Us Start free

    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

    • 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.3.0 for the latest Debian image or 16.3.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 or 16.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
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: