Public | Automated Build

Last pushed: a month ago
Short Description
Basic Docker image to run an ActorDB node.
Full Description

ActorDB for Docker

PLEASE NOTE: This is an unofficial package, go badger Biokoda for an official ActorDB image if that is of concern!

Supported Tags and Respective Dockerfile Links

What is ActorDB?

ActorDB is a ...

"Distributed SQL database with linear scalability.

ActorDB is strongly consistent, distributed and horizontally scalable.

Based on an industry-proven reliable database engine."

Please visit the ActorDB project's site for a full run-down and documentation.


You can use this image to start up an ActorDB node. You'll want to specify a host volume for where the data should be persisted between runs, and ports to connect to.

$ docker run -d -v /opt/actordb/data:/var/lib/actordb -p 33306:33306 -p 33307:33307 --name actordb bytepixie/actordb

The above starts up ActorDB in detached mode, with data stored locally in /opt/actordb/data, and ports 33306 and 33307 made available locally. It'll use the default app.config and vm.args installed by the .deb package.

You can also use the example schema setup to have a play...

$ docker exec -it actordb actordb_console -f /etc/actordb/init.example.sql
Config updated.
Config updated.
Schema updated.

... and then run some of the examples from the Get Started doc...

$ docker exec -it actordb actordb_console -u myuser -pw mypass
use config (use c)  initialize/add nodes and user account management
use schema (use s)  set schema
use actordb (use a) (default) run queries on database
open         (windows only) open and execute .sql file
q            exit
h            print this header
commit (c)   execute transaction
rollback (r) abort transaction
print (p)    print transaction
show (s)     show schema
show status  show database status
show queries show currently running queries
show shards  show shards on node

actordb> ACTOR type1(music) CREATE; 
actordb (1)> INSERT INTO tab (i,txt) VALUES (42,"this is our first run");
actordb (2)> c
Rowid: 1, Rows changed: 1
actordb> ACTOR type1(music); SELECT * FROM tab;
actordb (1)> c
i  id txt                   |
42 1  this is our first run |
actordb> ACTOR type1(sport) CREATE;
actordb (1)> INSERT INTO tab (i,txt) VALUES (1,"Insert into sport.");
actordb (2)> ACTOR type1(reading) CREATE;
actordb (3)> INSERT INTO tab (i,txt) VALUES (2,"Insert into reading.");
actordb (4)> ACTOR type1(paint) CREATE;
actordb (5)> INSERT INTO tab (i,txt) VALUES (3,"Insert into paint.");
actordb (6)> c
Rowid: 0, Rows changed: 3
actordb> ACTOR type1(sport,reading,paint);
actordb (1)> INSERT INTO tab (i,txt) VALUES (2,"Insert into three type1 actors.");
actordb (2)> c
Rowid: 0, Rows changed: 3
actordb> actor type1(*); {{RESULT}}select * from tab;
actordb (1)> c
actor   i  id txt                             |
sport   1  1  Insert into sport.              |
sport   2  2  Insert into three type1 actors. |
music   42 1  this is our first run           |
paint   3  1  Insert into paint.              |
paint   2  2  Insert into three type1 actors. |
reading 2  1  Insert into reading.            |
reading 2  2  Insert into three type1 actors. |
actordb> q

Use the MySQL client to connect.

$ mysql -umyuser -pmypass -h127.0.0.1 -P33307
Warning: Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 0
Server version: 5.5.0-myactor-proto 5.5.0-myactor-proto

Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> ACTOR type1(sport); SELECT * FROM tab;
Query OK, 0 rows affected (0.00 sec)

| id   | txt                             | i    |
|    1 | Insert into sport.              |    1 |
|    2 | Insert into three type1 actors. |    2 |
2 rows in set (0.00 sec)

mysql> exit;



By default the image exposes two ports:

  • 33306: Thrift client interface.
  • 33307: MySQL client interface.


By default the image exposes three volumes:

  • /var/lib/actordb: Data files.
  • /etc/actordb: Configuration files.
  • /var/log/actordb: Log files.


The default user is root, but the actordb process runs as an "actordb" user.

ActorDB Configuration Notes

Some things to remember when configuring ActorDB.

Each node you bring up must have a unique -name in its vm.args file. This means the part before the "@".

When using Docker, you can use the --name you give the container after the "@" in the -name setting of vm.args.
When using Docker Compose, you can use the service name after the "@" in the -name setting of vm.args.

You must remember to add each node that makes up a cluster into the nodes table. In the example init.example.sql it only inserts the current node's name, but you'll want to add the others.

use config
insert into groups values ('grp1','cluster')
-- localnode() is whatever is in vm.args (-name ....) for node we are connected to.
insert into nodes values (localnode(),'grp1')
insert into nodes values ('node2@actordb-server-2','grp1')
insert into nodes values ('node3@actordb-server-3','grp1')

The above is taken from an updated init.example.sql that is used for a very simple (and not very good) example Docker Compose setup.

Contributing & Issues

If you have problems with or questions about this image, please raise an issue on the GitHub repo.
Pull requests are even better!

Docker Pull Command
Source Repository

Comments (0)