15.2.4 Running Oracle Graph Quickstart Container Image

You can easily get started with the property graph feature of Oracle Database using the Oracle Graph Quickstart Container Image.

The image comprises the following components:

• Oracle Database 23ai Free (based on 23.7.0.0-lite) image
• JDK 21
• Graph Server (RPM file) and Client (25.2 version)

Also, note that the following are preconfigured in the database:

• GRAPHUSER user account.
• A sample SQL property graph called BANK_GRAPH based on bank transaction data.

Depending on your Linux version, you can use Docker or Podman to run the Oracle Graph Quickstart Container Image:

• Docker is available on Oracle Linux 7 (x86_64) and Red Hat Enterprise Linux 7.

  Refer to Oracle Container Runtime for Docker User's Guide for more information.

• Podman is available on Oracle Linux 8 (x86_64) and Red Hat Enterprise Linux 8.

  Refer to Podman User's Guide for more information.

Note that this image is not available for Oracle Linux 8 64-bit Arm architectures.

Before you get started, perform the following prerequisites:

1. Sign in to Oracle Container Registry and accept the Oracle Standard Terms and Restrictions to download the graph-quickstart image.
2. Generate an authentication token to authenticate Docker or Podman with the Oracle Container Registry.

   See Generating an Authentication Token for Use With the Oracle Container Registry for more information.

Perform the following steps to run the Oracle Graph Quickstart Container Image inside a Docker or Podman container.

1. Login from the host system by running the following command:
   • Linux 8
   • Linux 7

   podman login container-registry.oracle.com

   docker login container-registry.oracle.com

   If your host system is behind a firewall, then ensure that you configure the necessary proxy environment variables to the address of the proxy server.

   When prompted, provide your Oracle account username and the authentication token for password.

2. Download the latest graph-quickstart image from the Oracle Container Registry by running the following command:
   • Linux 8
   • Linux 7

   podman pull container-registry.oracle.com/database/graph-quickstart:25.2.0

   docker pull container-registry.oracle.com/database/graph-quickstart:25.2.0

   Alternatively, you can skip this step and run the container directly, which will automatically pull the image as shown in the next step.

3. Run the Oracle Graph Quickstart container as shown:
   • Linux 8
   • Linux 7

   podman run -d --name <container_name> -p <host_port>:7007 -e ORACLE_PWD=<database_password> container-registry.oracle.com/database/graph-quickstart:25.2.0

   docker run -d --name <container_name> -p <host_port>:7007 -e ORACLE_PWD=<database_password> container-registry.oracle.com/database/graph-quickstart:25.2.0

   In the preceding command:

   • --name: Specifies the name for the container.
   • -d: Indicates that the container is run at the background.
   • -p: The port mapping of the host port to the container port.
   • -e: Sets an environment variable (ORACLE_PWD) inside the container that specifies the Oracle Database password for GRAPHUSER and PDBADMIN user accounts.
   See the Oracle Graph Quickstart Container Image documentation page in Oracle Container Registry for more information.