docker-geneweb/README.md

55 lines
1.6 KiB
Markdown
Raw Normal View History

2016-11-06 10:00:33 +01:00
# docker-geneweb
Dockerized installation of Geneweb
2016-11-06 12:02:36 +01:00
The container does not include `gwsetup` by default but this is only installed once to create a database
*hint:* `gwsetup` is the program to create a genealogy database initially
## Usage
Usually you want to keep your database so to keep your data in an *existing* directory e.g. `${HOME}/GenealogyData`
Just run the container:
```
docker run --env LANGUAGE=de -d --name geneweb -p2316:2316 -p2317:2317 -v ${HOME}/GenealogyData:/genewebData schuellerf/geneweb:latest
2016-11-06 12:02:36 +01:00
```
2016-11-06 13:32:30 +01:00
and go to [http://localhost:2317](http://localhost:2317)
2016-11-06 12:02:36 +01:00
if you happen to have the git repository you can also execute:
```
./start.sh
```
**note:** the directory `${HOME}/GenealogyData` has to be a *full path*
## Setup
2016-11-06 13:32:30 +01:00
The setup will be started automatically [http://localhost:2316](http://localhost:2316) if no database can be found
2016-11-06 12:13:28 +01:00
2016-11-06 12:02:36 +01:00
**Please be patient** the setup tool will be installed "on the fly" only upon the *first start* if you don't have any genealogy database.
If you start the container and you already have a database but you want more databases or do some backup you need to start the setup manually like so:
```
docker exec geneweb /start_setup.sh
2016-11-06 12:02:36 +01:00
```
2016-11-06 13:32:30 +01:00
and then navigate to [http://localhost:2316](http://localhost:2316)
2016-11-06 12:02:36 +01:00
## Shutdown
To shutdown the container just run
```
docker stop geneweb
docker rm geneweb
2016-11-06 12:02:36 +01:00
```
## Backup
If you need to do a backup just either backup your data folder (e.g. `${HOME}/GenealogyData`)
2016-11-06 12:13:28 +01:00
To export the data as "*.ged" file or similar you need to start the "setup" tool
```
docker exec -ti geneweb /start_setup.sh
2016-11-06 12:13:28 +01:00
```
2016-11-06 13:32:30 +01:00
and then navigate to [http://localhost:2316](http://localhost:2316)
2016-11-06 12:02:36 +01:00