Difference between revisions of "Docker"

From GeneWeb
Jump to: navigation, search
Line 1: Line 1:
{{DISPLAYTITLE:Install GeneWeb on Mac, Linux and Windows using Docker}}
+
{{DISPLAYTITLE:Install GeneWeb on Mac, Linux or Windows using Docker}}
 
{{toc right}}
 
{{toc right}}
  

Revision as of 11:01, 4 May 2019

Running Geneweb in a Docker container

Download and install docker for your operating system from Docker.

To download the latest Dockerized image of Geneweb, open your favourite terminal and execute:

 docker pull jeffernz/geneweb:latest

The above command will download the latest Dockerized image of Geneweb. The image is built on top of Ubuntu:19.04

To run the Geneweb docker image as a container, run:

 docker run -d \
   --name jeffernz-geneweb \
   -p 2316:2316 -p 2317:2317 \
   -v ${HOME}/GenealogyData:/usr/local/var/geneweb \
   jeffernz/geneweb:latest

This will now launch the Geneweb portal at http://localhost:2317 and the Geneweb setup portal at http://localhost:2316

To run the Geneweb portal by itself, the command is:

 docker run -d \
   --name jeffernz-geneweb \
   -p 2317:2317 \
   -v ${HOME}/GenealogyData:/usr/local/var/geneweb \
   jeffernz/geneweb:latest \
   start-portal

To run the Geneweb Setup by itself, the command is:

 docker run -d \
   --name jeffernz-geneweb \
   -p 2316:2316 \
   -v ${HOME}/GenealogyData:/usr/local/var/geneweb \
   jeffernz/geneweb:latest \
   start-setup

Additional running options

We can provide additional options when you run the docker Geneweb image

To run Geneweb in a different language:

 -e LANGUAGE=de

To change the host ip-address when accessing Geneweb Setup portal

 -e HOST_IP=10.0.1.2

Geneweb bases storage

Once you run Geneweb in the dockerized container, the bases created in Geneweb will be stored under:

 ${HOME}/GenealogyData

Backing up the bases

To backup your bases on a running container:

docker exec -it \
   jeffernz-geneweb \
   backup.sh

The backup will be stored under

 ${HOME}/GenealogyData/backup