GeoServer Blog

GeoServer 2.20.6 Released

We are happy to announce GeoServer 2.20.6 release is available with downloads (bin, war, windows), along with docs and extensions.

This is the last planned maintenance release for the 2.20.x series, please consider upgrading to the 2.21.x series. This release was made in conjunction with GeoTools 26.6 and GeoWebCache 1.20.4.

Improvements and Fixes

  • It’s now possible to use the REST API to reset caches for a single store or a single layer.
  • GeoFence role filtering was improved.
  • OSHI was updated to allow gathering OS statistics on Apple M2 as well.
  • Assorted small improvements to the status page.
  • An infinite recursion in GWC transparent integration with WMS was spotted and fixed (affected vector tiles and layers with a meta-tiling factor of 1, when the “TILED” parameter was turned off).
  • The GWC module was split so that its REST API can be excluded (for completely headless installs).

For the full list of fixes and improvements, see 2.20.6 release notes.

About GeoServer 2.20

Additional information on GeoServer 2.20 series:

Release notes: (2.20.5 | 2.20.4 | 2.20.3 | 2.20.2 | 2.20.1 | 2.20.0 | 2.20-RC )

Read More

GeoServer 2.22-M0 Milestone Release

GeoServer 2.22-M0 release is now available with downloads (bin, war, windows), along with docs, extensions, and data directory.

This is a milestone release previewing the GeoServer 2.22.x series for FOSS4G attendees.

Thanks to Jody Garnett and Ian Turton for making this release.

Docker image

This release is also available as an official Docker image:

docker pull
docker run -it -p 80:8080

Welcome Page Improvements

The welcome page has been improved with the ability to:

  • Select workspace to browse workspace web services
  • Select layer and layergroup for layer specific web services

Welcome workspace

GeoPackage Sample data

The sample data directory now includes a small geopackage generated from Natural Earth data.

World map

About GeoServer 2.22

Release notes: ( 2.22-M0 )

Read More

GeoServer 2.21.1 Release

GeoServer 2.21.1 release is now available with downloads (bin, war, windows), along with docs and extensions.

This is a stable release of the GeoServer 2.21.x series, made in conjunction with GeoTools 27.1 and GeoWebCache 1.21.1.

Thanks to Jody Garnett (GeoCat) for making this release.

Server Status

The server status page has been cleaned up with a few quality of life improvements:

  • Units supplied for numbers, such as “7 threads” or “30,000 ms”
  • Number of items held in the resource cache is shown, so there is visual feed back when using Clear button.
  • Documentation has been updated to cover all the status field descriptions and document the available actions

For more information see Server Status page.

Server status

JVM Console

A new JVM Console tab has been added to the server status page allowing a summary of memory use to be reviewed and downloaded, and a summary of active threads to be reviewed and downloaded.

For more information see JVM Console.

JVM Console

Workspace headers for proxy url

A checkbox Use headers for Proxy URL has been added to the workspace page.

This setting an individual workspace use headers for proxy URL (even when the default in global settings has been disabled).

Improvements and Fixes


GEOS-10580 Server status page improvements for status, modules and docs

GEOS-10521 Allow GetFeatureInfo over raster layers to identify both original raster and transformed vectors

GEOS-10514 Better capture catalog configuration issues: layergroup with a misconfigured layer

GEOS-10501 GetMap: support auth headers forwarding to remote SLD urls

GEOS-10495 Request Logger Memory Buffer Limits

GEOS-10489 Add options to LDAP Role Service to configure prefixes and enforce capitalization

GEOS-10464 Improve logging and check for NPEs and other issues in Importer Module


GEOS-10584 Enabling logging of request body results in stream closed errors in tomcat environment

GEOS-10570 Deleting a style in a Hazelcast cluster renames the styles directory

GEOS-10553 Importer replace fails with schema mismatch

GEOS-10548 GeoFence layer group handling is inconsistent

GEOS-10546 Invalid time expressions used in WCS 2.0 subset return a code 200 with generic exception

GEOS-10545 Layer Group cache not initialized

GEOS-10539 DescribeLayer typeName is no longer workspace qualified

GEOS-10535 WFS Update request throw NPE on bad namespace

GEOS-10534 a badly formed delete transaction will get a NPE instead of an informative error message

GEOS-10533 Review startup logging INFO and WARN updates

GEOS-10526 Parallel REST API calls failures

GEOS-10522 REST API Failure in @ExceptionHandler No input String specified

GEOS-10518 Partial RELINQUISH_LOG4J_CONTROL regression with WildFly

GEOS-10516 WMS GetCapabilities dimension representations ignores the end attribute

GEOS-10496 Using the REST API to purge NetCDF granules causes a seemingly infinite loop

GEOS-10487 Custom logging configuration not respecting log location setting

GEOS-10468 (virtually) Impossible to turn off “Enable All Statistics” in > Server status > System Status


GEOS-10588 Build structure gs-sec-oauth2-core is duplicated in the reactor

GEOS-10585 Upgrade to Jetty from 9.4.44 to 9.4.48

GEOS-10579 Bump oshi-core from 6.2.0 to 6.2.1

GEOS-10562 Bump oshi-core from 5.8.6 to 6.2.0

GEOS-10551 Refactor commons-httpclient usage in the WPS module

GEOS-10532 FreemarkerTemplateManager API changes for easier subclassing

GEOS-10529 Use Awaitility to replace waits for condition in tests

GEOS-10525 Centralize and simplify management of common test dependencies

About GeoServer 2.21

Additional information on GeoServer 2.21 series:

Release notes: ( 2.21.1 | 2.21.0 | 2.21-RC )

Read More

GeoServer 2.20.5 Released

We are happy to announce GeoServer 2.20.5 release is available with downloads (bin, war, windows), along with docs and extensions.

This is a maintenance release of the 2.20.x series recommended for production systems. This release was made in conjunction with GeoTools 26.5 and GeoWebCache 1.20.3.

Improvements and Fixes

  • The request logger is now configurable from the UI (form the “Global settings” panel),
  • Importer improvements to support REPLACE mode on raster layers (in addition to the existing support for vector ones).
  • The KML-PPIO module has graduated to extension (allows KML encoding of feature collections in WPS processes). It’s now included in the WPS plugin download.
  • WPS fetching of remote inputs can be disabled.
  • Allow controlling usage of headers in proxy base URL expansion at the workspace level.

For the full list of fixes and improvements, see 2.20.5 release notes.

About GeoServer 2.20

Additional information on GeoServer 2.20 series:

Release notes: ( 2.20.2 | 2.20.1 | 2.20.0 | 2.20-RC )

Read More

GeoServer 2.21.0 Release

GeoServer 2.21.0 release is now available with downloads (bin, war, windows), along with docs and extensions.

This is a first release of the new stable branch of GeoServer and is made in conjunction with GeoTools 27.0 and GeoWebCache 1.21.0.

  • GeoServer now supports Java 17! This is likely to be the last release that supports Java 8 and we encourage users to start to make the transition to Java 11 during the lifetime of this branch.
  • Thanks to everyone who help tested the release candidate on and off list: Daniel Calliess, Georg Weickelt, Stefan Overkamp, Nicolas Matzick, Sander Schaminee, Jose Garcia, Rosa Briones, Jody Garnett, Andrea Aime, Ian Turton.

Thanks to Ian Turton, Astun Technology, for making this release.

Feature Type Customization

We are pleased to share a long-requested feature - the ability to rename attributes and change attribute order when publishing a FeatureType.

Feature type customization

It is also possible to change attribute type, and with the use of ECQL expressions generate new attributes on the fly.

The above example works around the limitations of shapefile to use longer names, and creates a new attribute capital on the fly from an expression, as shown in the following GetFeatureInfo output.

GetFeatureInfo tasmania_cities

This is a great new addition to GeoServer, please see Feture Type Details in the user guide for details.

Thanks to Andrea Aime (GeoSolutions) for proposal GSIP-207 and implementation, and Canton of Solothurn for funding the work.

Translations and Language Chooser

A big thanks to Alexandre Gacon and everyone who helped improve GeoServer internationalization for during this release cycle.

To support this activity Andrea Aime has contributed a language chooser to the top of the screen (near the login button).

Language chooser

For more information see Choosing the UI language (User Guide).

  • GEOS-1158 Specify Geoserver UI Language in Configuration

Add Styles support to LayerGroup

Layer groups can now be configured with additional styles, with each style listing a series of layers along with the style used to render each layer.

Layer group styles

This allows a SINGLE or OPAQUE layer group to list alternate styles in addition to the default one. Each alternate style is defined by a named configuration of layers and styles providing a unique visual representation.

In the above example the layer group Tasmania is setup with an alternate “data” presentation, presenting the content with the geoserver default styles point, line and polygon.

Layer group style Tasmania

For more information see Layer Group Styles (User Guide).

  • GEOS-10252 Add Styles support to LayerGroup
  • GEOS-10274 Geofence follow up LayerGroup Style addition

Thanks to Marco Volpini (GeoSolutions) for GSIP-205 proposal and implementation, and the Swedish Agency for Marine and Water Management for sponsoring this new functionality.

GeoPackage WMS and WFS Output

The result of proposal GSIP-206 is the creation of the gs-geopkg-output extension packaging up the WFS and WMS output formats from the geopackage community module.

curl "http://localhost:8080/geoserver/wfs?service=wfs&version=2.0.0&request=GetFeature&typeNames=topp:states&outputFormat=geopkg" -o wfs.gpkg

For more information see Using the GeoPackage Output Extension in the user guide.

  • GEOS-10351 [GSIP 206] Promote GeoPackage WFS and WMS output formats to an extension
  • GEOS-8793 WFS 1.1.0/2.0.0 GeoPackage output wrong Coordinate Order

Thanks to David Blasby and Jody Garnett (GeoCat) for packaging up this work as an extension. This work was supported in part by Rijkswaterstaat.

Mark Factory Precedence

When rendering maps with lots of individual graphics, looking up the correct implementation (known as a MarkFactory) can be time consuming.

WMS Settings have new capability to filter out any mark factories not being used, and provide an order to prioritise the ones being used.

MarkFactory precedence

For more information see WMS Web Administration (user guide).

  • GEOS-10230 MarkFactory WMS rendering performance optimization

Thanks to Fernando Mino (GeoSolutions Group) for troubleshooting this performance issue, and proposal GSIP-204 as an optimization. Thanks to EMSA for sponsoring the improvement.

Log4J 2 Upgrade

The assessment of Log4Shell vulnerability highlighted that although GeoSever was not affected, our use of the older Log4j 1.2 was a notable risk. This discussion resulted a small fundraising effort and proposal to upgrade to Log4j 2.

The result is a small change to the user interface, listing logging profiles by name (previously the file extension was also listed).

Log4j update

Internally this release changes from Log4j 1.2 logging profiles (using properties extension) to Log4j 2 logging profiles (using xml extension):

  • The built-in logging profiles (DEFAULT_LOGGING, PRODUCTION_LOGGING, …) are replaced with new Log4j 2 xml files.

  • Previous custom logging profiles will continue to be available (Log4J 2 has the ability to read the older Log4J 1.2 properties files).

  • If you made any customizations to the built-in profiles, you can recover your changes from backup bak file. You can use this backup as a reference when creating a new xml logging profile, or restore this under a different name which does not conflict with the built-in logging profiles.

    A customization to will be backed up to This can be restored by renaming to

In addition to the INFO status messages, you will notice a new CONFIG logging level used during application startup:

CONFIG [org.geoserver] - GeoServer configuration lock is enabled
CONFIG [org.geoserver] - Loading catalog...

For more information, and examples of writing a Log4J 2 profile, see Logging Settings and Advanced log configuration in the User Guide.

Thanks to Jody Garnett (GeoCat) for completing this work, and to the following sponsors for supporting this activity.

Logging REST API

For more information please see Logging settings (User Guide) and GeoServer Logging (REST API).

  • GEOS-10368 Logging Controller Addition allows configuration of logging via REST API.

Thanks to Yalın Eren Deliorman (GeoSolutions) for this contribution, and Eumetsat for sponsoring the work.

New WPS settings and KML input/output support

A number of improvements have been made to the WPS service:

  • GEOS-10443 Graduate kml-ppio community module to wps extension. Thanks to GeoSolutions for taking the maintainership of the module, and Masego Inc. for sponsoring the graduation work.

    KML can now be used with WPS service for both input and output parameters.

  • GEOS-10391 Add external output directory setting to limit where processes can write

    See WPS setting for external output directory in User Guide.

  • GEOS-10431 Add WPS setting to disable remote complex inputs.

    See WPS Security and input limits in the User Guide.

Thanks to the GeoNode project for these WPS improvements.

GDAL 3.x Compatibility

The gdal-output extension is tested against GDAL 3.x series.

Please pay careful attention to the installation instructions, while the extensions includes gdal-3.2.0.jar you should double check the native binaries (included in your Linux distribution or installed by hand) and download an appropriate replacement jar online.

For more information see Installing GDAL native libraries in the User Guide.

  • GEOS-10402 Upgrade imageio-ext to 1.4.0 (tested with gdal 3.2)

Thanks to Andrea Aime (GeoSolutions) for making the ImageIO-EXT release, and Jody Garnett (GeoCat) for GDAL 3.x upgrade and testing. This work was supported in part by Rijkswaterstaat.

Improvements and Fixes

New features:

  • GEOS-10228 Add wrap_limit property to wrap the category text values of a legend


  • GEOS-10146 App-schema: support for multiple geometries with different CRS
  • GEOS-10246 jdbcconfig: performance slow-down from unnecessary transactions
  • GEOS-10251 Refactor MapML vocabulary to map- custom elements HTML namespace
  • GEOS-10463 Support WCS default value for Deflate Compression
  • GEOS-10320 Support GetFeatureInfo on raster layers with transformations turning the output into vector
  • GEOS-10405 GetFeatureInfo: Support multiple featureCollections per query layer


  • GEOS-10226 ResourcePool leaves empty files on failure
  • GEOS-10318 CSV output format for complex features doesn’t resolve namespace URIs to prefixes on attributes names
  • GEOS-10235 Prevent double-quote to be specified as CSV separator
  • GEOS-10477 SLD - Validation error on Normalize-node
  • GEOS-10448 GetTimeSeries does not limit number of dates when using a time range request (without period)
  • GEOS-10429 Style validation error using the VendorOption “graphic-margin”
  • GEOS-10318 CSV output format for complex features doesn’t resolve namespace URIs to prefixes on attributes names
  • GEOS-10502 GML3 output is not pretty printed when pretty print is turned on in global settings.


  • GEOS-10458 Update jai-ext to 1.1.22
  • GEOS-10446 Upgrade to commons-codec 1.15 version
  • GEOS-10363 Switch from itextpdf to openpdf for PDF map rendering

About GeoServer 2.21

Additional information on GeoServer 2.21 series:

Release notes: ( 2.21.0, 2.21-RC )

Read More