Difference between revisions of "Docker"
Line 17: | Line 17: | ||
--name jeffernz-geneweb \ | --name jeffernz-geneweb \ | ||
-p 2316:2316 -p 2317:2317 \ | -p 2316:2316 -p 2317:2317 \ | ||
− | -v | + | -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 | + | -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 | + | -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: | ||
− | + | ~/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 |
− | |||
− | |||
The backup will be stored under | The backup will be stored under | ||
− | + | ~/GenealogyData/backup | |
{{manual}} | {{manual}} | ||
[[Category:Manual]] | [[Category:Manual]] |
Revision as of 00: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
- 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.