Setting up a local environment

OGC API modules are still in their infancy and under heavy development. Most of the specs and extensions are still in draft form and their behavior is likely to change in the next months/year. For this reasons this section explains how to set up a local environment using the latest GeoServer build.

From the GeoServer download page click on the development tab and then on the link to the main branch nightly builds.

../_images/download-page.png
  1. Make sure you have a Java Runtime Environment (JRE) installed on your system. GeoServer requires a Java 11 environment (or optionally, a Java 17 one), as provided by the Adoptium open source project.
  2. Download the geoserver-main-latest-bin.zip. Unzip it in a directory of your choice.
  3. Download all the necessary geoserver-<version>-SNAPSHOT-ogcapi-<service>-plugin.zip. Unzip them and drop all their content in the webapps/geoserver/WEB-INF/lib folder of your GeoServer directory.
  4. In the GeoServer bin directory, locate the start.ini file, open it, and change the property jetty.http.port to 8083, so as not to conflict with other applications that might be running on 8080. The rest of this training assumes GeoServer is running on port 8083.
  5. If you are using Java 17 or later, move into webapss/geoserver/WEB-INF/lib and remove the file named marlin-<version>.jar (e.g. marlin-0.9.3.jar).

Setting environment variables

You will need to set the JAVA_HOME environment variable if it is not already set. This is the path to your JRE such that %JAVA_HOME%\bin\java.exe exists.

To set the JAVA_HOME in Linux/OSX run the following commands:

  1. export JAVA_HOME=/path/to/jre
  2. export PATH=$JAVA_HOME/bin:$PATH

To set the JAVA_HOME in Windows:

  1. Navigate to Control Panel ‣ System ‣ Advanced ‣ Environment Variables.
  2. Under System variables click New.
  3. For Variable name enter JAVA_HOME. For Variable value enter the path to your JDK/JRE.
  4. Click OK three times.

Running

To start GeoServer:

  • On Linux/OSX open the terminal, navigate to the root directory of you GeoServer installation and run bin/startup.sh.
  • On Windows run startup.bat inside the bin folder. A command-line window will appear and persist. This window contains diagnostic and troubleshooting information. This window must be left open, otherwise GeoServer will shut down.

Once GeoServer is running:

  1. Navigate to http://localhost:8083/geoserver to access the GeoServer home.
  2. Check that ogcapi modules are installed by looking on the left side of the GeoServer home page. Under the section Service Capabilities you should have the following links:
../_images/ogcapi-services.png

Stopping

To shut down GeoServer:

  • On Linux/OSX press CTRL-C on the terminal where GeoServer is running.
  • On Windows either close the persistent command-line window, or run the shutdown.bat file inside the bin directory.

Uninstallation

  1. Stop GeoServer (if it is running).
  2. Delete the directory where GeoServer is installed.