The files here support building and running RavenDB 4.1 in a docker container on either Linux or Windows (nanoserver).

Official Docker images are available on our Docker Hub. We provide images in two flavors: ubuntu-based (to be run on Linux containers) and nanoserver-based (to be run using Windows containers). The following tags are available:

• 4.1-ubuntu-latest - contains the latest version of RavenDB 4.1 running on Ubuntu 18.04 container

• 4.1-windows-nanoserver-latest - contains the latest version of RavenDB 4.1 running running on Windows nanoserver

• every 4.1 release is going to have its own image set for both Ubuntu and Windows containers

Simplest way to run and try RavenDB out is:

Linux image:

$ docker run -p 8080:8080 ravendb/ravendb:4.1-ubuntu-latest

Windows image:

$ docker run -p 8080:8080 ravendb/ravendb:4.1-windows-nanoserver-latest

Optionally nightly images can be used from ravendb/ravendb-nightly

You can run RavenDB docker container manually by invoking docker run, yet if you don't feel that docker-savvy we recommend using our scripts:

Run Ubuntu-based image: run-linux.ps1

Run Windows-based image: run-nanoserver.ps1

Above mentioned Powershell scripts are simplifying usage of our images allowing you to pass various switches and options to configure RavenDB inside the container:

Once run RavenDB server should be exposed on port 8080 by default.

Each of images above makes use of 2 volumes:

• settings volume - holding RavenDB configuration,

  Ubuntu container: /opt/RavenDB/config

  Windows container: C:\RavenDB\Config

• databases volume - used for persistence of RavenDB data,

  Ubuntu container: /opt/RavenDB/Server/RavenData

  Windows container: C:/RavenDB/Server/RavenData

To configure RavenDB one can use (in order of precedence):

- environment variables, 

- `settings.json` configuration file, 

- CLI arguments

Environment variables prefixed with RAVEN_ can be used to configure RavenDB server. E.g. one can use:

RAVEN_Setup_Mode='None'

to disable RavenDB Setup Wizard.

Set Setup.Mode configuration option to None like so:

RAVEN_Setup_Mode='None'

Set env variables like so:

RAVEN_Setup_Mode='None'
RAVEN_Security_UnsecuredAccessAllowed='PrivateNetwork'

By modifying RAVEN_ARGS environment variable. It's passed as an CLI arguments line.

To get logs available when running docker logs command, you need to turn that on for RavenDB server. Setting below environment variables like so is going to enable logging to console. Please note such behavior may have performance implications. Log level may be modified using RAVEN_Logs_Mode variable.

RAVEN_ARGS='--log-to-console'

Mount it as a docker volume and use --config-path PATH_TO_CONFIG command line argument in order to use settings file from outside of server directory.

These images were built using the following Dockerfiles:

• Windows Nanoserver image Dockerfile

• Ubuntu 18.04 image Dockerfile