Difference between revisions of "Docker"
Line 67: | Line 67: | ||
${HOME}/GenealogyData/backup | ${HOME}/GenealogyData/backup | ||
+ | |||
+ | {{manual}} | ||
+ | |||
+ | [[Category:Manual]] |
Revision as of 13:49, 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 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
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
GeneWeb Manual
- Download and install GeneWeb program under GNU/Linux, Mac OS X, Microsoft Windows, FreeBSD; on Mac OS X, Linux or Windows using Docker; or in CGI mode behind a web server.
- Understand GeneWeb server, homonym, consanguinity.
Use and manage genealogical databases
- Import Gedcom
.ged
or GeneWeb.gw
files with gwsetup or in command-line. - Update datas (add/remove individuals and families), merge duplicates, type dates.
- Use wikitext syntax, macros, keyboard shortcuts.
- Clean, recover, rename, save, archive a database.
- Merge and split multiples databases.
Technical annex
- Personalize CSS, header and trailer, templates, lexicon and declension.
- Configuration file
.gwf
(for templm), wizard notes, passwords for friends/wizards and access restrictions to databases. - Add images in notes, further remarks for experts.