docker-geneweb/README.md
Florian Schüller ac4b894f2c Fixes #1
2016-12-22 15:45:26 +01:00

65 lines
1.8 KiB
Markdown

# docker-geneweb
Dockerized installation of [Geneweb](https://en.wikipedia.org/wiki/GeneWeb)
## 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
```
and go to [http://localhost:2317](http://localhost:2317)
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
The setup will be started automatically [http://localhost:2316](http://localhost:2316) if no database can be found
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
```
and then navigate to [http://localhost:2316](http://localhost:2316)
## Options
If you need to change the IP of the Docker host or better, of the PC you want to use the [setup](http://localhost:2316) from
you can override the default value by _adding_ the option
```
--env HOST_IP=192.168.0.1
```
to the `docker run` mentioned above.
e.g.
```
docker run --env HOST_IP=192.168.0.1 --env LANGUAGE=de -d --name geneweb -p2316:2316 -p2317:2317 -v ${HOME}/GenealogyData:/genewebData schuellerf/geneweb:latest
```
## Shutdown
To shutdown the container just run
```
docker stop geneweb
docker rm geneweb
```
## Backup
If you need to do a backup just either backup your data folder (e.g. `${HOME}/GenealogyData`)
To export the data as "*.ged" file or similar you need to start the "setup" tool
```
docker exec -ti geneweb /start_setup.sh
```
and then navigate to [http://localhost:2316](http://localhost:2316)