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

    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.), 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 .

    AlloyDB Omni runs in a container. Install a container runtime like Docker or Podman on your machine before installing AlloyDB Omni.

    Install AlloyDB Omni using Docker

    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
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: