AntidoteDB
  • Overview
  • Quickstart
  • Examples & Applications
    • Timeseries Load Generator
    • Antidote Web Shell
    • Calendar App
    • Todo List App
  • Tutorials
    • Java Tutorial
  • Related Projects
  • Architecture
    • Overview
    • Ring
    • Log
    • Materializer
    • Transaction Manager
    • Inter-DC Communication
    • Failure Modes
    • Datatypes in Antidote
    • Commit Hooks
    • Features Configuration
  • Deployment
    • Natively (Linux)
    • Local Docker Setup
    • Docker Compose Setups
    • Docker Swarm
    • Kubernetes
  • Monitoring
    • Prometheus and Grafana
  • API
    • Native (Erlang)
    • Protocol Buffer API
    • Erlang
    • Java
    • JavaScript
    • Go
    • Python
  • Benchmarking
    • Setup
    • Basho Bench
  • Tools
    • Logs and Cache Dump
  • Development
    • Setup & Environment
    • Building a Release
    • Testing
    • Contributing
    • Archived Works
  • Release Notes
    • 0.2.1
    • 0.1.1
    • 0.0.1
Powered by GitBook
On this page
  • Overview
  • Requirements
  • Supported tags and respective Dockerfile links
  • Starting a local node
  • Building the image locally
  • Using the local node
  • Connect to the console
  1. Deployment

Local Docker Setup

Guide into using Antidote's Docker images.

PreviousNatively (Linux)NextDocker Compose Setups

Last updated 5 years ago

Overview

For easy installation and deployment, we recommend to use Antidote's Docker images.

AntidoteDB has several Docker images hosted in . You can also find its sources and Dockerfiles in the .

The hub repository provides images for Antidote releases (currently 0.2.1 / 0.1.1).

Requirements

Working recent version of Docker (1.12 and up recommended, see the ).

Supported tags and respective Dockerfile links

The AntidoteDB images come in many flavors, each designed for a specific use case.

  • antidotedb:latest: the most recent AntidoteDB version (unstable).

  • antidotedb:stable: the most recent stable official release (recommended).

  • antidotedb:alpine: the most recent lightweight alpine release (stable).

  • antidotedb:<release>: Docker image for a specific version of AntidoteDB

  • antidotedb:<release>-alpine: This variant, available for each official release, is recommended when final image size being as small as possible is desired. The main caveat to note is that it use instead of , so certain software might run into issues depending on the depth of their libs requirements. However, most software does not have an issue with this, so this variant is usually a very safe choice. See for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images.

Supported tags and respective Dockefile github links:

Starting a local node

Start a local node with the command

docker run -d --name antidote1 -p "8087:8087" -e "NODE_NAME=antidote@antidote1" antidotedb/antidote:stable

This should fetch the Antidote image automatically. For updating to the latest version use the command docker pull antidotedb/antidote:stable.

Building the image locally

For building the Docker image on your local machine

Then you can run it using:

docker run -d --name antidote1 -p "8087:8087" -e "NODE_NAME=antidote@antidote1" antidotedb:local-build

To remove the local Docker image, you can use:

make docker-clean

Using the local node

Wait until Antidote is ready. The current log can be inspected with docker logs antidote1. Wait until the log message Application antidote started on node 'antidote@127.0.0.1' appears.

Antidote should now be running on port 8087 on localhost.

Connect to the console

You can connect to the console of a local node typing the following:

docker exec -it antidote1 /antidote/bin/antidote remote_console

: the most recent AntidoteDB version (Unstable).

: the most recent stable release (recommended).

: the most recent lightweight alpine release.

1) Clone the 2) Checkout the version you want to clone 3) Run make docker-build

Docker Hub
dedicated github repository
Docker installation Guide
musl libc
glibc and friends
this Hacker News comment thread
latest
0.2.1, stable
0.2.0
0.2.0-alpine, alpine
0.1.1
0.1.1-alpine
0.1.0
AntidoteDB repository