2 Running Oracle Graph Quickstart Container Image

You can easily get started with the property graph feature in your database using the Oracle Graph Quickstart Container Image.

The image comprises the following components:

• Oracle AI Database 26ai Free (based on 23.26.0.0-lite) image
• JDK 21
• Graph Server (RPM file) and Client (25.4 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.

You can use Podman (available on Oracle Linux 8 (x86_64) and later, Red Hat Enterprise Linux 8 and later) to run the Oracle Graph Quickstart Container Image. 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 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.

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

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

   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

   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 database password for GRAPHUSER and PDBADMIN user accounts.
   See the Oracle Graph Quickstart Container Image documentation page in Oracle Container Registry for more information.