GOAT is a web-application and is designed to feel at home on the Linux operating system. However, with the help of containers (Docker) and/or virtual machines (VM) you can install it on your Windows or Mac for development and testing. You are supposed to type some commands into the command line, in case you are not familiar with the command line you can find many tutorials on the web.
1. Get a copy of GOAT
It is recommended to use Git for fetching the project. Clone the GOAT-repo to a folder of your choice. Navigate first to the folder and run:
git clone https://github.com/goat-community/goat.git (run on your host)
2. Use Docker on your host to install software
Install Docker & Docker-Compose
Depending on your operating system there are different ways to install docker and docker-compose.
If you are on Windows follow:
https://docs.docker.com/docker-for-windows/install/ (Both docker and docker-compose are installed with the same installer)
As docker and docker-compose were originally build for the Linux OS, it could be that you experience issues, when installing Docker on your Windows machine. There are some common issues and possible solutions listed here:
3. Configure GOAT
In case you want to customize GOAT, there is one key configuration file for setting up GOAT. You can find this file at
At the moment not all configuration possibilities are in here but it is targeted to move more and more of the configuration in here.
It is recommended to open the files with a proper editor such as Visual Studio Code.
4. Prepare your data
If you want to apply the tool to your own study area or adjust the input data, follow the description at Data Preparation.
5. Setup GOAT
Open a command window and go into the project folder. You will run all commands directly from your host.
Install all the software and start services:
docker-compose up -d (This will start all service you need for goat (Database, Geoserver, NodeJS, etc.))
Fill and prepare the goat-database:
docker exec -it goat-database python3 /opt/setup_goat.py -t new_setup
GOAT allows you to use pre-calculated matrices that are used to visualize the dynamic heatmaps. In order to start the pre-calculation you currently have to start the script manually with the following command:
docker exec -it goat-database python3 /opt/setup_goat.py -p
Depending on the size of your study-area this can take some time. For Munich approx. 10 minutes.
Note you can also run both tasks at the same time:
docker exec -it goat-database python3 /opt/setup_goat.py -n new_setup -p
There are more flags for the setup script, which you could explore by running:
docker exec -it goat-database python3 /opt/setup_goat.py -h
For more Docker commands checkout:
6. Connect to your database
You can connect to the PostgreSQL database with the following default credentials:
Change your credentials especially if you want to run GOAT in production
7. View GOAT in the browser
If all steps were successful you will be able to use GOAT by typing the following into your browser:
8. How start and stop GOAT
Navigate to your GOAT-folder (in this folder there should be the docker-compose.yml file)
docker-compose down (This will stop all running containers)
docker-compose up -d (This will start all containers defined in the docker-compose.yml file)
9. Backup Database
This command will produce a database backup at
docker exec -it goat-database python3 /opt/setup_goat.py -b -n your-namespace
10. Update data
In case you want to update all your data and pre-compute the heatmap again, you can simply run the following from your project directory:
docker exec -it goat-database python3 /opt/setup_goat.py -t new_setup -p
!!Note this will drop your database and create a new database.!!