Intelligent software for modern web mapping and integrated planning
Website

GOAT is a free and open source WebGIS platform. It is an all-in-one solution for integrated planning, with powerful GIS tools, integrated data, and comprehensive accessibility analyses for efficient planning and fact-based decision-making.

Try it out in the cloud at goat.plan4better.de

For more information check out:

GOAT Docs

Follow GOAT on LinkedIn

Follow GOAT on Twitter

GOAT is a monorepo project leveraging a modern, full-stack architecture.

• 💻 Typescript

• 🚀 Next.js

• 🗺️ Maplibre GL JS

• ⚛️ React

• 🎨 MUI

• 🔒 Auth.js

• 🧘‍♂️ Zod

• 🐍 Python

• ⚡️ FastAPI

• 📦 Pydantic

• 🗄️ SQLAlchemy

• 📊 PostgreSQL with PostGIS

• 🔐 Keycloak

GOAT is also available as a fully hosted cloud service. If you prefer not to manage your own infrastructure, you can get started instantly with our trial version and choose from one of our available subscription tiers. Get started at goat.plan4better.de.

Official support: We provide a maintained docker-compose.yml for running the full GOAT stack in a production‑like environment.

Important: While we provide Docker resources, self‑hosted deployments are community‑supported. We do not offer official support for managing your infrastructure.

The images for each GOAT service are published on GitHub Container Registry.

Make sure the following are installed on your server or local machine:

• Docker
• Docker Compose (plugin syntax: docker compose)
• At least 8 GB RAM recommended

The default docker-compose.yml provisions:

• PostgreSQL with PostGIS
• Keycloak
• MinIO (S3 compatible storage)
• GOAT Core (FastAPI backend)
• GOAT GeoAPI (FastAPI backend for geodata)
• GOAT Web (Next.js frontend)

git clone https://github.com/plan4better/goat.git
cd goat

Copy .env:

cp .env.example .env

Update all required environment variables (see “Environment Variables” section below).

This ensures you always run the latest published versions and avoids building anything locally.

docker compose pull

docker compose up -d

Since images were pulled beforehand, no build steps will run — everything starts immediately.

• Web UI: http://localhost:3000
• Core API: http://localhost:8000/api
• GeoAPI: http://localhost:8100
• MinIO Console: http://localhost:9001
• Keycloak Admin: http://localhost:8080

To update an existing installation:

docker compose down
docker compose pull
docker compose up -d

This will:

1. Stop your stack
2. Fetch the latest published images
3. Restart without rebuilding

If you are developing the GOAT codebase or making changes to apps/core, apps/geoapi, or apps/web, you may need to build images manually.

Run:

docker compose up -d --build

Only use this if you’re modifying the GOAT source code.

GOAT is a commercial open‑source project. The core platform is licensed under the GNU General Public License v3.0 (GPLv3), which allows anyone to use, modify, and distribute the software under the terms of the GPL.

Some components, such as the Accounts API and features related to user management, teams, or organizations, are not open source and are provided under a commercial license. These components are not required for running the core platform but are available for organizations that need advanced functionality, hosted deployments, or enterprise‑level capabilities.

This structure makes GOAT accessible for everyone, while providing extended functionalities through optional commercial services.

We welcome contributions of all kinds, bug reports, documentation improvements, new features, and feedback that helps strengthen the platform. Please see our contributing guide.