Installation with Docker¶
This chapter describes how to install the CBGM installation on your own PC with the help of Docker. Docker can run our application on Linux, Mac, and Windows.
We plan to offer various Docker images preloaded with data. The data is editable so you can build your own scenarios.
Warning
As of now (September 2019) this is a technology preview. More functionality will be added and bugs will be fixed later. Feedback is welcome at: https://github.com/cceh/ntg/issues
Warning
These instructions are tested only on Linux. Feedback from Windows and Mac users is welcome: https://github.com/cceh/ntg/issues
Install¶
Install the free community version of Docker:
for Windows see: https://docs.docker.com/docker-for-windows/install/
for Mac see: https://docs.docker.com/docker-for-mac/install/
for Debian Linux see: https://docs.docker.com/compose/install/
Create a new directory and change into it.
Download https://raw.githubusercontent.com/SCDH/intf-cbgm/master/docker/docker-compose.yml
Run:
$ docker-compose up
This will download the Docker containers and initialize the database. It will take some time depending on your internet connection speed and your PC.
Test the installation: Point your browser to the url: http://localhost:5000/acts/ph4/ and use the application.
When satisfied, hit Ctrl+C to stop the Docker service.
The Docker service is now installed.
Running the web application¶
To use the application point your browser to http://localhost:5000/acts/ph4/ while the Docker service is running. To run the Docker service change into the directory and say:
$ docker-compose start
and to stop it again say:
$ docker-compose stop
Troubleshooting¶
After upgrading to a new docker container, if you get the error message: “FATAL: database files are incompatible with server”, say:
$ docker-compose down --volumes
$ docker-compose up
Warning
This will install a fresh database and overwrite all changes you made to the data.