Development Usage

Please note! This Docker setup is not for production!

Quickstart

After cloning the repo, try this:

mvn -Pct clean package docker:run

After some time you should be able to log in:

Intro

Assuming you have Docker, Docker Desktop, Moby or some remote Docker host configured, up and running from here on. Also assuming you have Java and Maven installed, as you are at least about to develop code changes.

To test drive these local changes to the Dataverse codebase in a containerized application server (and avoid the setup described in Development Environment), you must a) build the application container and b) run it in addition to the necessary dependencies.

Building and Running

To build the application image, run the following command, as described in Dataverse Application Image:

mvn -Pct clean package

Now, start all the containers with a single command:

mvn -Pct docker:run

(You could also concatenate both commands into one, as shown above in the quickstart.)

Check that you can log in to http://localhost:8080 using user dataverseAdmin and password admin1.

You can also access the Payara Admin Console if needed, which is available at http://localhost:4848. To log in, use user admin and password admin. As a reminder, the application container is for development use only, so we are exposing the admin console for testing purposes. In a production environment, it may be more convenient to leave this console unopened.

Note that data is persisted in ./docker-dev-volumes in the root of the Git repo. For a clean start, you should remove this directory before running the mvn commands above.