Difference between revisions of "Docker"
Line 59: | Line 59: | ||
~/GenealogyData | ~/GenealogyData | ||
− | === | + | === Export as GEDCOM === |
To backup your bases on a running container: | To backup your bases on a running container: | ||
Line 68: | Line 68: | ||
~/GenealogyData/backup | ~/GenealogyData/backup | ||
+ | |||
+ | === Import from GEDCOM === | ||
+ | |||
+ | To import a GEDCOM file into GeneWeb, place the GEDCOM file under ''~/GenealogyData/import | ||
+ | and then execute the import command on the running instance. e.g. | ||
+ | |||
+ | docker exec -it jeffernz-geneweb import.sh | ||
+ | |||
+ | This will import the GEDCOM file into GeneWeb. Note, all GEDCOM files in the import | ||
+ | folder will be imported. Make sure you remove older files to prevent the database | ||
+ | from being overwritten. | ||
{{manual}} | {{manual}} | ||
[[Category:Manual]] | [[Category:Manual]] |
Revision as of 03:53, 1 June 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
Export as GEDCOM
To backup your bases on a running container:
docker exec -it jeffernz-geneweb backup.sh
The backup will be stored under
~/GenealogyData/backup
Import from GEDCOM
To import a GEDCOM file into GeneWeb, place the GEDCOM file under ~/GenealogyData/import and then execute the import command on the running instance. e.g.
docker exec -it jeffernz-geneweb import.sh
This will import the GEDCOM file into GeneWeb. Note, all GEDCOM files in the import folder will be imported. Make sure you remove older files to prevent the database from being overwritten.
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.