Web archive

GeoServer is packaged as a standalone servlet for use with existing application servers such as Apache Tomcat and Jetty.

Note

GeoServer has been mostly tested using Tomcat, and so is the recommended application server. GeoServer requires a newer version of Tomcat (7.0.65 or later) that implements Servlet 3 and annotation processing. Other application servers have been known to work, but are not guaranteed.

Installation

  1. Make sure you have a Java Runtime Environment (JRE) installed on your system. GeoServer requires a Java 8 or Java 11 environment, available from OpenJDK, AdoptOpenJDK for Windows and macOS installers, or provided by your OS distribution.

    Note

    For more information about Java and GeoServer, please see the section on Java Considerations.

  2. Navigate to the GeoServer Download page.

  3. Select Web Archive on the download page.

  4. Download and unpack the archive.

  5. Deploy the web archive as you would normally. Often, all that is necessary is to copy the geoserver.war file to the application server’s webapps directory, and the application will be deployed.

    Note

    A restart of your application server may be necessary.

Running

Use your container application’s method of starting and stopping webapps to run GeoServer.

To access the Web administration interface, open a browser and navigate to http://SERVER/geoserver . For example, with Tomcat running on port 8080 on localhost, the URL would be http://localhost:8080/geoserver.

Uninstallation

  1. Stop the container application.

  2. Remove the GeoServer webapp from the container application’s webapps directory. This will usually include the geoserver.war file as well as a geoserver directory.