Quickstart

Overview

This page shows how to quickly set up an Aerospike Graph installation using Docker. Follow the instructions below to install a one-node Aerospike Graph Service (AGS) instance and a one-node Aerospike database cluster within seconds.

The following procedure uses a Docker Compose script to pull the required Docker images and start them on your local machine. The included Python script demonstrates connecting to the AGS server and adding a vertex.

Set up the Graph environment

1. Clone the Aerospike Graph repository then navigate to the new directory.

   git clone https://github.com/aerospike/aerospike-graph.git
   cd aerospike-graph

2. Use Docker compose to start both the Aerospike Database and the Aerospike Graph Service (AGS) in detached mode.

   docker compose up -d

3. Run the Python example app. With AGS running, you can now test it using the Python example app in the examples directory. First, set up a Python virtual environment:

   python3 -m venv .venv
   source .venv/bin/activate

4. Install the required packages and run the example.

   python3 -m pip install gremlinpython async_timeout
   python ./examples/python-example.py

   The simple example app shows how to connect to an Aerospike Graph deployment and add a vertex.

Next steps

• Experiment with a more complex dataset.
• Learn about deploying AGS with Docker.