Official Repository

Last pushed: a day ago
Short Description
RethinkDB is an open-source, document database that makes it easy to build and scale realtime apps.
Full Description

Supported tags and respective Dockerfile links

For more information about this image and its history, please see the relevant manifest file (library/rethinkdb). This image is updated via pull requests to the docker-library/official-images GitHub repo.

For detailed information about the virtual/transfer sizes and individual layers of each of the above supported tags, please see the repos/rethinkdb/ file in the docker-library/repo-info GitHub repo.

What is RethinkDB?

RethinkDB is an open-source, distributed database built to store JSON documents and effortlessly scale to multiple machines. It's easy to set up and learn and features a simple but powerful query language that supports table joins, groupings, aggregations, and functions.

How to use this image

Start an instance with data mounted in the working directory

The default CMD of the image is rethinkdb --bind all, so the RethinkDB daemon will bind to all network interfaces available to the container (by default, RethinkDB only accepts connections from localhost).

docker run --name some-rethink -v "$PWD:/data" -d rethinkdb

Connect the instance to an application

docker run --name some-app --link some-rethink:rdb -d application-that-uses-rdb

Connecting to the web admin interface on the same host

$BROWSER "http://$(docker inspect --format \
  '{{ .NetworkSettings.IPAddress }}' some-rethink):8080"

Connecting to the web admin interface on a remote / virtual host via SSH

Where remote is an alias for the remote user@hostname:

# start port forwarding
ssh -fNTL localhost:8080:$(ssh remote "docker inspect --format \
  '{{ .NetworkSettings.IPAddress }}' some-rethink"):8080 remote

# open interface in browser
xdg-open http://localhost:8080

# stop port forwarding
kill $(lsof -t -i @localhost:8080 -sTCP:listen)


See the official docs for infomation on using and configuring a RethinkDB cluster.


View license information for the software contained in this image.

Supported Docker versions

This image is officially supported on Docker version 17.03.0-ce.

Support for older versions (down to 1.6) is provided on a best-effort basis.

Please see the Docker installation documentation for details on how to upgrade your Docker daemon.

User Feedback


If you have any problems with or questions about this image, please contact us through a GitHub issue. If the issue is related to a CVE, please check for a cve-tracker issue on the official-images repository first.

You can also reach many of the official image maintainers via the #docker-library IRC channel on Freenode.


You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.


Documentation for this image is stored in the rethinkdb/ directory of the docker-library/docs GitHub repo. Be sure to familiarize yourself with the repository's file before attempting a pull request.

Docker Pull Command

Comments (13)
4 months ago

Do I need to do something for it to accept a connection from another docker image? I get ConnectionRefused when I try to connect to it from a docker aspnetcore running Docker for windows

6 months ago

@holms, I just created an alpine based image:
It is using the currently available rethinkdb alpine package - 2.3.1-r0 from edge branch, testing repo.

6 months ago

Hi. I´m building my custom container. My Dockerfile starts with the following line:

FROM rethinkdb:2.3.4

But when I start the container, the UI is saying to me that the running version is 2.3.5~0jessie.
Am I missing something?

8 months ago

Any plans for alpine version? Please..?

a year ago

how can I change the cache size in a docker-compose file?

a year ago

It would be nice to have some information on how to create shards with this image

a year ago

I'm new to docker so my question might be silly.
Do you think I can use this image straight in production ?
What should I do to secure this image and a docker installation ?

a year ago

exec format error when running on my ArmV7 32 bit CPU. Does this image support this kind of CUP?

a year ago

The SSH tunneling doens't seem to be working, is there an example of how to forward the admin interface when using docker-machine?

2 years ago

If you want to access it from outside a container (like an application running in the host machine), you should export port 28015 (and also 8080, if you want to access admin interface):

docker run --name some-rethink -v "$PWD:/data" -p 8080:8080 -p 28015:28015 -d rethinkdb