geoservercloud/geoserver-cloud-rest repository overview

⁠GeoServer Cloud — REST Configuration API

GeoServer REST configuration API⁠ microservice for GeoServer Cloud⁠. Programmatic endpoint for managing workspaces, stores, layers, styles, services, and security.

• Project: github.com/geoserver/geoserver-cloud⁠
• Documentation: geoserver.org/geoserver-cloud⁠
• License: GPL-2.0⁠
• Source: src/apps/geoserver/restconfig⁠

⁠About GeoServer Cloud

GeoServer⁠ is an open-source server for sharing geospatial data. GeoServer Cloud repackages GeoServer as a set of independently deployable and scalable microservices built on Spring Boot and Spring Cloud.

⁠What this image provides

A self-contained REST API microservice exposing the full GeoServer configuration surface:

• Workspaces, namespaces, data stores, coverage stores
• Layers, layer groups, styles (SLD, CSS, MBStyle)
• Service settings (WMS, WFS, WCS, WPS, GWC)
• Security: users, groups, roles, access rules
• Importer endpoints and resource uploads

The image is built on a GeoServer base layer and includes an AOT cache for fast JVM startup. It runs behind the GeoServer Cloud Gateway⁠, which routes /rest requests to it.

⁠Tags

• <version> — stable release (e.g. 3.0.0)
• <version>-RC<n> — release candidate (e.g. 3.0.0-RC1)
• <version>-SNAPSHOT — development snapshot from main

No latest tag is published — always pin to a specific version. Images are multi-arch (linux/amd64, linux/arm64) and signed with cosign⁠.

⁠Quick start

Deploy together with the other GeoServer Cloud services via:

• Docker Compose: examples in the project repo⁠
• Kubernetes: the camptocamp/helm-geoserver-cloud⁠ Helm chart

Standalone smoke test (no config server, no catalog, no data):

docker run --rm -p 9105:9105 \
  -e SPRING_PROFILES_ACTIVE=standalone,datadir \
  -e GEOSERVER_DATA_DIR=/tmp/datadir \
  geoservercloud/geoserver-cloud-rest:3.0.0-SNAPSHOT

Exercise the API:

curl -u admin:geoserver http://localhost:9105/rest/workspaces.json

⁠Configuration

See the Externalized configuration guide⁠ for the full list of profiles and options.

⁠Support

• Issues: github.com/geoserver/geoserver-cloud/issues⁠
• Discussions: geoserver.org/comm⁠