Installation

Dependencies

JDK < 17 is not supported by the latest Geoweaver.
If you cannot upgrade Java, use Geoweaver 2.1.x (Java 11). See Java 17 migration guide and Releases (example: v2.1.7 jar).

Check your runtime:

java -version

Who should read what?

You are… Do this
New user Install Java 17+, then use Quick Install below.
Existing 2.1.x user upgrading Follow Upgrading and Java 17 migration (back up ~/h2 first).
Stuck on Java 11 Stay on Geoweaver 2.1.x; do not use the latest 2.2+ jar until JDK 17 is available.

Quick Install

(Applicable on Linux, macOS, and Windows)

If you have Python installed:

Step 1: Open a Terminal/Prompt and run:

pip install pygeoweaver --upgrade

Step 2: After pygeoweaver is installed, run:

gw start

Recent pygeoweaver versions expect Java 17+ for the current Geoweaver line and will warn / exit if the JDK is too old.

Step 3: Open a browser: http://localhost:8070/Geoweaver/

Java Way

If you only have a JDK (no Python):

Step 1: Install Java 17+, then download the latest geoweaver.jar.

Step 2: From the folder that contains the jar:

java -jar geoweaver.jar

Step 3: Open http://localhost:8070/Geoweaver/

To stay on the Java 11–compatible line, download a 2.1.x jar from Releases instead of latest.

Build from source

Requires JDK 17+ and Maven.

mvn clean install
java -jar target/geoweaver.jar

The package is produced under Geoweaver/target/ (e.g. geoweaver.jar / versioned artifact).

Install using Docker

Step 1: Install Docker Desktop if you haven’t (see Get Docker).

Step 2: Pull the image:

docker pull geoweaver/geoweaver

For other tags, see Docker Hub.

Step 3: Run:

docker run -t -i -v <YOUR_HOME_DIRECTORY>:/home/marsvegan/ -p 8070:8070 -e PASSWORD="YOUR_PASSWORD" geoweaver/geoweaver

-v <YOUR_HOME_DIRECTORY>:/home/marsvegan/ mounts your home directory into the container. marsvegan is the user inside the image. -p 8070:8070 exposes the UI. -e PASSWORD=... sets the localhost password.

Tip — create an alias:

alias geoweaver="docker run -t -i -v <YOUR_HOME_DIRECTORY>:/home/marsvegan/ -p 8070:8070 geoweaver/geoweaver"

Step 4: Open http://localhost:8070/Geoweaver/

Reset Password for Localhost

Geoweaver creates a localhost password on first run (shown once). To reset:

java -jar geoweaver.jar resetpassword

With Docker:

docker run -t -i -v <YOUR_HOME_DIRECTORY>:/home/marsvegan/ -p 8070:8070 jensensun/geoweaver resetpassword

Set up HTTP Proxy

See HTTP proxy.

Changing the listening port

Default port is 8070. To change it:

Using Environment Variable

Linux/macOS:

export GEOWEAVER_PORT=8081

Windows Command Prompt:

set GEOWEAVER_PORT=8081

Windows PowerShell:

$env:GEOWEAVER_PORT=8081

Then start Geoweaver and open the matching URL (e.g. http://localhost:8081/Geoweaver/).