Skip to main content

Developer Tutorials

These Aerospike tutorials will help developers quickly learn and enjoy using Aerospike Database. They contain both:

  • Concepts – Explanations of common database and Aerospike concepts.
  • Code – Functioning Aerospike API code snippets.

Using Jupyter Notebooks

To install these tutorials as part of a complete Aerospike development environment in a Docker container, go here.

To check out what the development environmment offers, click the "Launch with Binder" link at the beginning of any tutorial. Binder creates a fresh container for your temporary use.

Tutorial Sections

The following types of tutorial are already available:

Aerospike also provides client APIs for Go, Node.js, C, C#, and more.

Please provide feedback and suggestions for new tutorials.

Run Tutorials in a Docker Container

These tutorials can be installed and run locally in a Docker container in just a few minutes. The Docker image contains an interactive Aerospike development environment.

  1. Install Docker.

  2. Get the Docker image.

    docker pull aerospike/intro-notebooks
  3. Run the image and expose port 8888:

    docker run --name aero-nb -p 8888:8888 aerospike/intro-notebooks
  4. Point your browser at the url with token which should be printed on the output. By default it should be:<token>


$ docker run --name aero-nb -p 8888:8888 aerospike/intro-notebooks

link eth0 state up
link eth0 state up in 0
Set username to: jovyan
usermod: no changes
Executing the command: jupyter notebook
[I 05:28:34.202 NotebookApp] Writing notebook server cookie secret to /home/jovyan/.local/share/jupyter/runtime/notebook_cookie_secret
[I 05:28:34.954 NotebookApp] JupyterLab extension loaded from /opt/conda/lib/python3.8/site-packages/jupyterlab
[I 05:28:34.954 NotebookApp] JupyterLab application directory is /opt/conda/share/jupyter/lab
[I 05:28:34.957 NotebookApp] Serving notebooks from local directory: /home/jovyan/notebooks
[I 05:28:34.957 NotebookApp] Jupyter Notebook 6.1.4 is running at:
[I 05:28:34.957 NotebookApp] http://6a374afd9f00:8888/?token=c45783e6631e305c97f6919905250e61f09049e750813cf6
[I 05:28:34.957 NotebookApp] or
[I 05:28:34.957 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).

Docker Installation Options

To get started, There are advanced options for installation, including:

  • Building the image from the Git repo.
  • Specifying a LOGFILE location for the built-in Aerospike Database.
  • Setting up the Spark tutorials on on Linux (CentOS) and MacOS X.

Go here for instructions.

Development Environment Contents

The following software is in the Docker Image:

  • Aerospike development software:
    • Aerospike Database
    • Aerospike Java and Python Client Libraries
    • Aerospike Tools
  • Jupyter Notebook Server