Install AlloyDB Omni

Select a documentation version: 15.5.4 keyboard_arrow_down

• Current (16.8.0)
• 16.8.0
• 16.3.0
• 15.12.0
• 15.7.1
• 15.7.0
• 15.5.5
• 15.5.4
• 15.5.2

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.

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

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.5.4 
   

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

1. 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.

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 :

    docker  
   container  
   stop  
   my-omni 
   

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

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

What's next

• Run and connect to AlloyDB Omni

• Customize your AlloyDB Omni installation

• Set up your AlloyDB Omni for production