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.

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. Binder's container creation time is significant sometimes.

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 uplink eth0 state up in 0Set username to: jovyanusermod: no changesExecuting 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