Deploying on Docker

The easiest way to deploy a Curiosity Workspace is to run it as a Docker container.

Docker is an open platform for developing, shipping, and running applications. Docker enables you to separate your applications from your infrastructure so you can deliver software quickly. In order to get started, you will need to have a working Docker installation on your machine or server.

Requirements

You can follow the official Docker documentation on how to install it on your operating system.

Docker Image

The Curiosity Docker Image is available in the official Docker repository.

You can download the image from the registry using docker pull:

docker pull curiosityai/curiosity

This will pull the latest available image from the Docker registry.

To hard-code your deployment to a specific version, you can add the version number on the end of the command:

docker pull curiosityai/curiosity:VERSION

We recommend you locking the image version in production, so you can have more control over deploying updates

Configuration

Configure Curiosity using environment variables when you start the container. See Configuration for a list of all configurable variables.

You must configure the values that are required for a standard installation. Unlike in the Installation guide, you cannot use a YAML file in the root folder of the app, therefore pass the configuration variables directly to the docker run command:

mkdir -p ~/curiosity/storage
docker run -p 8080:8080 -v ~/curiosity/storage/:/data/ -e storage=/data/curiosity

If you're running on Windows, you will need to adapt the paths as required:

mkdir c:\curiosity\storage
docker run -p 8080:8080 -v c:/curiosity/storage/data/:/data/ -e storage=/data/curiosity

On Windows, Docker expects you to use / instead of \ for mounting the volume

You should be able to navigate on your browser to the port mapped above:

http://localhost:8080.

The username and password for your first log is in both cases: admin. You can now follow the steps under Configure your Workspace.