nephantes/dolphinnext-docker repository overview

⁠DolphinNext docker version

DolphinNext original repository is located at https://github.com/UMMS-Biocore/dolphinnext⁠.

For a quick start please check our quick start guide. https://dolphinnext.readthedocs.io/en/latest/dolphinNext/quick.html⁠

DolphinNext can also be run as a standalone application using a docker container. First docker image need to be build unless you want to use prebuild from dockerhub. So, any change in the Dockerfile requires to build the image. But if you want to use prebuild version just skip building it and start the container.

⁠Build docker image

1. To build docker image first clone one of the latest dolphinnext-docker

git clone https://github.com/UMMS-Biocore/dolphinnext-docker.git

1. Build the image

cd dolphinnext-docker
docker build -t dolphinnext-docker .

⁠Start the container

1. We move database outside of the container to be able to keep the changes in the database everytime you start the container. Please choose a directory in your machine to mount and replace /path/to/mount with your path.

• Note: Please don't change the target directory(/export) in the docker image.

mkdir -p /path/to/mount

1. While running the container;

docker run -m 10G -p 8080:80 -v /path/to/mount:/export -ti dolphinnext-docker /bin/bash

*if you want to run a pre-build

docker run -m 10G -p 8080:80 -v /path/to/mount:/export -ti ummsbiocore/dolphinnext-docker /bin/bash

or with R markdown support;

docker run -m 10G -p 8080:80 -v /path/to/mount:/export -ti ummsbiocore/dolphinnext-studio /bin/bash

1. After you start the container, you need to start the mysql and apache server usign the command below;

startup

1. Verify that dolphinnext and mysql folders located inside of the export folder:

ls /export

1. Now, you can open your browser to access dolphinnext using the url below.

http://localhost:8080/dolphinnext⁠

⁠Running on the Amazon or Google Cloud

We define localhost:8080 in /path/to/mount/dolphinnext/config/.sec file and use that to log in or other operations. You need to change localhost to that IP address or amazon/google domain you use. So static IP address would solve the issue that you will not need to change it every time you create an instance. Please update BASE_PATH and PUBWEB_URL as follows:

BASE_PATH = http://localhost:8080/dolphinnext
PUBWEB_URL = http://localhost:8080/dolphinnext/tmp/pub

to

BASE_PATH = http://your_temporary_domain_name:8080/dolphinnext
PUBWEB_URL = http://your_temporary_domain_name:8080/dolphinnext/tmp/pub

• Please don’t change other lines because others are used inside of docker.