Difference between revisions of "Docker"

From GeneWeb
Jump to: navigation, search
(Additional running options)
(Running Geneweb in a Docker container)
Line 17: Line 17:
 
     --name jeffernz-geneweb \
 
     --name jeffernz-geneweb \
 
     -p 2316:2316 -p 2317:2317 \
 
     -p 2316:2316 -p 2317:2317 \
     -v ${HOME}/GenealogyData:/usr/local/var/geneweb \
+
     -v ~/GenealogyData:/usr/local/var/geneweb \
 
     jeffernz/geneweb:latest
 
     jeffernz/geneweb:latest
  
Line 27: Line 27:
 
     --name jeffernz-geneweb \
 
     --name jeffernz-geneweb \
 
     -p 2317:2317 \
 
     -p 2317:2317 \
     -v ${HOME}/GenealogyData:/usr/local/var/geneweb \
+
     -v ~/GenealogyData:/usr/local/var/geneweb \
 
     jeffernz/geneweb:latest \
 
     jeffernz/geneweb:latest \
 
     start-portal
 
     start-portal
Line 36: Line 36:
 
     --name jeffernz-geneweb \
 
     --name jeffernz-geneweb \
 
     -p 2316:2316 \
 
     -p 2316:2316 \
     -v ${HOME}/GenealogyData:/usr/local/var/geneweb \
+
     -v ~/GenealogyData:/usr/local/var/geneweb \
 
     jeffernz/geneweb:latest \
 
     jeffernz/geneweb:latest \
 
     start-setup
 
     start-setup
Line 57: Line 57:
 
Once you run Geneweb in the dockerized container, the bases created in Geneweb will be stored under:
 
Once you run Geneweb in the dockerized container, the bases created in Geneweb will be stored under:
  
   ${HOME}/GenealogyData
+
   ~/GenealogyData
  
 
=== Backing up the bases ===
 
=== Backing up the bases ===
Line 63: Line 63:
 
To backup your bases on a running container:
 
To backup your bases on a running container:
  
  docker exec -it \
+
  docker exec -it jeffernz-geneweb backup.sh
    jeffernz-geneweb \
+
    backup.sh
+
  
 
The backup will be stored under
 
The backup will be stored under
  
   ${HOME}/GenealogyData/backup
+
   ~/GenealogyData/backup
  
 
{{manual}}
 
{{manual}}
  
 
[[Category:Manual]]
 
[[Category:Manual]]

Revision as of 01:33, 18 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 ~/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 ~/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 ~/GenealogyData:/usr/local/var/geneweb \
   jeffernz/geneweb:latest \
   start-setup

Additional running options

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

To run Geneweb in a different language (default is set to english):

 -e LANGUAGE=de

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

 -e HOST_IP=10.0.1.2

To run GeneWeb in a different timezone. This is useful if you want to look at history of the edits and determine the correct time it was made for your timezone.

 -e TZ=Australia/Melbourne

Geneweb bases storage

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

 ~/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

 ~/GenealogyData/backup

GeneWeb Manual

Rembrandt Old Man Reading a Book.jpg

Use and manage genealogical databases

Technical annex