[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eAlloyDB Omni can be installed in any UNIX-based environment that supports container runtimes, requiring minimum hardware like an x86-64 or Arm CPU with AVX2 support, 2 GB of RAM, and 10 GB of disk space.\u003c/p\u003e\n"],["\u003cp\u003eA container runtime such as Docker or Podman needs to be installed before you can install AlloyDB Omni, which will then run within a container.\u003c/p\u003e\n"],["\u003cp\u003eInstallation is done by using the \u003ccode\u003edocker run\u003c/code\u003e command, which creates a new container and allows you to set a password for the container's \u003ccode\u003epostgres\u003c/code\u003e user.\u003c/p\u003e\n"],["\u003cp\u003eYou can connect to your containerized AlloyDB Omni instance using \u003ccode\u003epsql\u003c/code\u003e via the command \u003ccode\u003edocker exec -it my-omni psql -h localhost -U postgres\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe container's data directory is deleted when the AlloyDB Omni container is removed unless you mount a data directory on your host file system, which would require customization.\u003c/p\u003e\n"]]],[],null,["# Install AlloyDB Omni\n\nSelect a documentation version: 15.5.4keyboard_arrow_down\n\n- [Current (16.8.0)](/alloydb/omni/current/docs/quickstart)\n- [16.8.0](/alloydb/omni/16.8.0/docs/quickstart)\n- [16.3.0](/alloydb/omni/16.3.0/docs/quickstart)\n- [15.12.0](/alloydb/omni/15.12.0/docs/quickstart)\n- [15.7.1](/alloydb/omni/15.7.1/docs/quickstart)\n- [15.7.0](/alloydb/omni/15.7.0/docs/quickstart)\n- [15.5.5](/alloydb/omni/15.5.5/docs/quickstart)\n- [15.5.4](/alloydb/omni/15.5.4/docs/quickstart)\n- [15.5.2](/alloydb/omni/15.5.2/docs/quickstart)\n\n\u003cbr /\u003e\n\n| **Note:** Your use of AlloyDB Omni is subject to the agreement between you and Google that governs Google Cloud offerings. If you do not have a Google Cloud account, or have not otherwise entered into an agreement with Google that governs Google Cloud offerings, please do not proceed or download this software until you have done so. To create a Google Cloud account, see [the Google Cloud homepage](/docs/get-started).\n\n\u003cbr /\u003e\n\nThis quickstart shows you how to install AlloyDB Omni that can run\nin any UNIX-based environment which supports container runtimes.\n\nFor an overview of AlloyDB Omni, see [AlloyDB Omni overview](/alloydb/omni/15.5.4/docs).\n\nBefore you begin\n----------------\n\nThe following table lists minimum hardware and software requirements for AlloyDB Omni.\n\nAlloyDB Omni runs in a container. Install a container runtime like [Docker](https://docs.docker.com/engine/install/) or [Podman](https://podman.io/docs/installation) on your machine before installing AlloyDB Omni.\n\nInstall AlloyDB Omni using Docker\n---------------------------------\n\n| **Note:** [Root access](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) is not required for installing AlloyDB Omni.\n\n1. Use the `docker run` command to create a new container with AlloyDB Omni named `my-omni`:\n\n docker run --name my-omni \\\n -e POSTGRES_PASSWORD=\u003cvar translate=\"no\"\u003eNEW_PASSWORD\u003c/var\u003e \\\n -d google/alloydbomni:15.5.4\n\n Replace \u003cvar translate=\"no\"\u003eNEW_PASSWORD\u003c/var\u003e with a password to assign the new container's `postgres` user after its creation.\n\n| **Note:** By default, AlloyDB Omni stores your data on the container itself, and not on your host file system. The data directory is deleted once you delete your AlloyDB Omni container. To mount a data directory stored on your host file system, see instructions in [Customize your AlloyDB Omni installation](/alloydb/omni/15.5.4/docs/install).\n\n1. Connect to containerized AlloyDB Omni using `psql`:\n\n docker exec -it my-omni psql -h localhost -U postgres\n\n The terminal window displays `psql` login text that ends with a\n `postgres=#` prompt.\n\nClean up\n--------\n\nTo clean up the AlloyDB Omni container you created during this quickstart, use these steps:\n\n1. Stop your AlloyDB Omni container named `my-omni`:\n\n docker container stop my-omni\n\n2. Delete your AlloyDB Omni container named `my-omni`:\n\n docker container rm my-omni\n\nFor instructions how to install AlloyDB Omni in a new container for production usage, go to the [Customize your AlloyDB Omni installation](/alloydb/omni/15.5.4/docs/install) page.\n\nWhat's next\n-----------\n\n- [Run and connect to AlloyDB Omni](/alloydb/omni/15.5.4/docs/run-connect)\n\n- [Customize your AlloyDB Omni installation](/alloydb/omni/15.5.4/docs/install)\n\n- [Set up your AlloyDB Omni for production](/alloydb/omni/15.5.4/docs/configure-omni)"]]