Web archive (WAR)

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

Note

GeoServer has been mostly tested using Tomcat, and therefore these instructions may not work with other container applications.

Java

GeoServer requires Java to be installed on your system. Oracle Java SE 6 or newer is strongly recommended. (As of GeoServer 2.2.x, Oracle JRE 5 is no longer supported.) A Java Development Kit (JDK) is not required to run GeoServer. For more information about Java and GeoServer, please see the section on Java Considerations.

Installation

  1. Navigate to the GeoServer Download page and pick the appropriate version to download.

  2. Select Web archive on the download page.

  3. Download and unpack the archive. Copy the file geoserver.war to the directory that contains your container application’s webapps.

  4. Your container application should unpack the web archive and automatically set up and run GeoServer.

    Note

    A restart of your container application may be necessary.

Running

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

  1. To access the Web Administration Interface, open a browser and navigate to http://container_application_URL/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.