GeoServer Core Server

Architecture Overview

System Components

Multi-threaded spatial processing pipeline with lazy evaluation, query optimization, and automatic tile generation.

Unified ingestion layer supporting vector, raster, point-cloud, and mesh formats with automatic reprojection.

Stateless HTTP/gRPC endpoints with built-in caching, request throttling, and granular access control.

Technical Specifications

OGC Protocols	`WMS 1.3.0` `WFS 2.0` `WCS 2.0` `WMTS 1.0` `FeatureServer`
Native Formats	`GeoJSON` `GeoPackage` `PostGIS` `COG` `LAS/LAZ` `Parquet`
Authentication	JWT, OAuth2, SAML 2.0, API Keys, mTLS
Caching	Redis, CloudFront-compatible, Tiered L1/L2 disk cache
Scaling	Stateless workers, horizontal auto-scaling, read replicas
Observability	Prometheus metrics, OpenTelemetry tracing, JSON/ELK logs

Deployment

Run a standalone instance with default configuration.

docker run -d \
  -p 8080:8080 \
  -v ./data:/var/lib/geoserver \
  --name geoserver-core \
  ghcr.io/geoserver/core:4.2.1

Deploy using the official manifest.

kubectl apply -f \
  https://raw.githubusercontent.com/geoserver/manifests/main/core-server.yaml

Install via Helm chart.

helm install gs-core \
  oci://ghcr.io/geoserver/charts/core \
  --set replicaCount=3 \
  --set persistence.size=100Gi

Direct system installation (Linux/macOS).

curl -fsSL https://install.geoserver.dev/core | sudo bash
sudo systemctl enable --now geoserver-core

Integration

GET

/v2/feature/{workspace}/{layer}

Retrieve feature collections with bbox, cql_filter, and property selection.

POST

/v2/feature/{workspace}/{layer}/transaction

Upsert/delete features. Supports GeoJSON & GML payloads.

GET

/v2/tile/{workspace}/{layer}/{z}/{x}/{y}@{scale}.png

Mapbox/XYZ tile endpoint with optional format & style parameters.

POST

/v2/ingest

Stream multipart uploads for batch spatial data ingestion.

Infrastructure