Administration on Windows

This document contains information about various tasks specific to Boundless Server for Windows.

Boundless services

Boundless Server is comprised of two services:

  1. The Tomcat web server that contains all the web applications such as GeoServer and GeoWebCache. The service can be started / stopped from the Tomcat Configuration Manager application which can be found by Start ‣ Configure Tomcat.

  2. The PostgreSQL database server with the PostGIS spatial extensions.


    The Boundless PostgreSQL service is only available through the virtual machine.

Service port configuration

The Tomcat and PostgreSQL services run on ports 8080 and 5432 respectively. These ports can often conflict with existing services on the system, in which case the ports must be changed.

Changing the Tomcat port

The Tomcat port can be changed on installation.

To change the Tomcat port after installation:

  1. Open the server.xml file, typically located in your Tomcat conf directory (such as C:\Program Files (x86)\Apache Software Foundation\Tomcat 9\conf).

  2. Search for the following line:

    <Connector port="8080" protocol="HTTP/1.1"
  3. Change the port value.

  4. Save the file.

  5. Restart Tomcat.


To change the port on the Boundless Server virtual machine, connect to the virtual machine with a Terminal, and follow the Ubuntu instructions.

Changing the PostgreSQL port


The Boundless PostgreSQL service is only available through the virtual machine. Connect to the virtual machine with a terminal, and follow the Ubuntu instructions.

GeoServer data directory

The GeoServer data directory is the location on the file system where GeoServer stores all of its configuration, and (optionally) file-based data.

By default, this directory is located at C:\ProgramData\Boundless\geoserver\data.

To point GeoServer to an alternate location:

  1. Edit the geoserver.xml file in your Tomcat configuration directory. This is usually located in C:\Program Files (x86)\Apache Software Foundation\Tomcat 9\conf\Catalina\localhost.

  2. Define GEOSERVER_DATA_DIR with an appropriate value accordingly.

    <Parameter name="GEOSERVER_DATA_DIR"
        value="C:\ProgramData\Boundless\geoserver\data" override="false"/>
  3. Restart the Tomcat service.


For more information, see the section on Deploying the GeoServer WAR.