# geoserver/geoserver architecture

> Architecture diagram of the GitHub repository geoserver/geoserver, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/geoserver/geoserver
- Repository: https://github.com/geoserver/geoserver

## Overview

GeoServer is a Java geospatial server for sharing and editing spatial data through OGC and related standards. A client requests a service operation; service handlers use the catalog and configured data sources to find or retrieve geospatial resources, then return a standards-format response. The tree also shows REST catalog management and security services as distinct capabilities. Source excerpts directly show the OGC API Coverages handler delegating coverage retrieval to WCS 2.0; other service-to-catalog relationships are documented only at product level in the README, so those edges are marked accordingly.

Main entry points: [`src/main/src/main/java/org/geoserver/catalog/Catalog.java`](https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/catalog/Catalog.java) (Catalog index), [`src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java`](https://github.com/geoserver/geoserver/blob/main/src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java) (OGC API Coverages), [`src/wcs2_0/src/main/java/org/geoserver/wcs2_0/DefaultWebCoverageService20.java`](https://github.com/geoserver/geoserver/blob/main/src/wcs2_0/src/main/java/org/geoserver/wcs2_0/DefaultWebCoverageService20.java) (Web Coverage Service), [`src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java`](https://github.com/geoserver/geoserver/blob/main/src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java) (Coverage REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_services["OGC Services"]
  node_wms["Web Map Service"]
  node_wfs["Web Feature Service"]
  node_wcs["Web Coverage Service"]
  node_ogcapi_cov["OGC API Coverages"]
  node_ogcapi_features["OGC API Features"]
  node_csw["Catalog Service"]
  node_wps["Processing Service"]
  node_oseo["Earth Observation"]
  node_covjson["CoverageJSON encoder<br/>[Coverage.java]"]
end

subgraph group_catalog["Catalog and Data"]
  node_catalog_core[("Catalog index<br/>[Catalog.java]")]
  node_coverage_info["Coverage metadata<br/>[CoverageInfo.java]"]
  node_layer_info["Layer metadata<br/>[LayerInfo.java]"]
  node_coverage_store["Coverage store"]
  node_config["Server configuration<br/>[GeoServer.java]"]
end

subgraph group_api["Management APIs"]
  node_rest_coverage["Coverage REST API"]
  node_rest_upload["Coverage file API"]
  node_rest_base["REST framework"]
end

subgraph group_security["Security"]
  node_user_groups["User group service"]
  node_auth_users["Authorized user groups"]
  node_auth_roles["Authorized roles"]
end

node_client(("Geospatial client"))

node_client -->|"requests maps"| node_wms
node_client -->|"requests features"| node_wfs
node_client -->|"requests coverages"| node_wcs
node_client -->|"requests coverages"| node_ogcapi_cov
node_client -->|"requests features"| node_ogcapi_features
node_client -->|"searches catalog"| node_csw
node_client -->|"requests processing"| node_wps
node_client -.->|"searches products"| node_oseo
node_wms -->|"publishes maps"| node_client
node_wfs -->|"publishes features"| node_client
node_wcs -->|"publishes coverages"| node_client
node_ogcapi_features -->|"publishes features"| node_client
node_csw -->|"publishes catalog"| node_client
node_wps -->|"returns results"| node_client
node_oseo -->|"returns products"| node_client
node_ogcapi_cov -->|"delegates retrieval"| node_wcs
node_ogcapi_cov -.->|"formats response"| node_covjson
node_ogcapi_cov -->|"looks up catalog"| node_catalog_core
node_rest_coverage -->|"reads catalog"| node_catalog_core
node_rest_upload -->|"updates catalog"| node_catalog_core
node_rest_coverage -.->|"extends framework"| node_rest_base
node_rest_upload -.->|"extends framework"| node_rest_base
node_catalog_core -->|"indexes coverage"| node_coverage_info
node_coverage_info -->|"uses store"| node_coverage_store
node_catalog_core -->|"indexes layers"| node_layer_info
node_config -->|"holds catalog"| node_catalog_core
node_user_groups -->|"wrapped by"| node_auth_users
node_auth_users -->|"delegates operations"| node_user_groups

click node_wms "https://github.com/geoserver/geoserver/blob/main/src/wms-core/src/main/java/org/geoserver/wms/DefaultWebMapService.java"
click node_wfs "https://github.com/geoserver/geoserver/blob/main/src/wfs-core/src/main/java/org/geoserver/wfs/DefaultWebFeatureService.java"
click node_wcs "https://github.com/geoserver/geoserver/blob/main/src/wcs2_0/src/main/java/org/geoserver/wcs2_0/DefaultWebCoverageService20.java"
click node_ogcapi_cov "https://github.com/geoserver/geoserver/blob/main/src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java"
click node_ogcapi_features "https://github.com/geoserver/geoserver/blob/main/src/extension/ogcapi/ogcapi-features/src/main/java/org/geoserver/ogcapi/v1/features/FeatureService.java"
click node_csw "https://github.com/geoserver/geoserver/blob/main/src/extension/csw/core/src/main/java/org/geoserver/csw/DefaultWebCatalogService.java"
click node_wps "https://github.com/geoserver/geoserver/blob/main/src/community/wps-openai/src/main/java/org/geoserver/llm/cache/LlmCacheManager.java"
click node_oseo "https://github.com/geoserver/geoserver/blob/main/src/community/oseo/oseo-service/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java"
click node_covjson "https://github.com/geoserver/geoserver/blob/main/src/community/cov-json/src/main/java/org/geoserver/wcs/responses/covjson/Coverage.java"
click node_rest_coverage "https://github.com/geoserver/geoserver/blob/main/src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java"
click node_rest_upload "https://github.com/geoserver/geoserver/blob/main/src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageStoreFileController.java"
click node_rest_base "https://github.com/geoserver/geoserver/blob/main/src/rest/src/main/java/org/geoserver/rest/RestBaseController.java"
click node_catalog_core "https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/catalog/Catalog.java"
click node_coverage_info "https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/catalog/CoverageInfo.java"
click node_layer_info "https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/catalog/LayerInfo.java"
click node_coverage_store "https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/catalog/CoverageStoreInfo.java"
click node_config "https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/config/GeoServer.java"
click node_user_groups "https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/security/GeoServerUserGroupService.java"
click node_auth_users "https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java"
click node_auth_roles "https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/security/AuthorizingRoleService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_wms,node_wfs,node_wcs,node_ogcapi_cov,node_ogcapi_features,node_csw,node_wps,node_oseo,node_covjson,node_client toneBlue
class node_catalog_core,node_coverage_info,node_layer_info,node_coverage_store,node_config toneAmber
class node_rest_coverage,node_rest_upload,node_rest_base toneMint
class node_user_groups,node_auth_users,node_auth_roles toneRose
```

## Components

### OGC Services

- [Web Map Service](https://github.com/geoserver/geoserver/blob/main/src/wms-core/src/main/java/org/geoserver/wms/DefaultWebMapService.java): `src/wms-core/src/main/java/org/geoserver/wms/DefaultWebMapService.java`
- [Web Feature Service](https://github.com/geoserver/geoserver/blob/main/src/wfs-core/src/main/java/org/geoserver/wfs/DefaultWebFeatureService.java): `src/wfs-core/src/main/java/org/geoserver/wfs/DefaultWebFeatureService.java`
- [Web Coverage Service](https://github.com/geoserver/geoserver/blob/main/src/wcs2_0/src/main/java/org/geoserver/wcs2_0/DefaultWebCoverageService20.java): `src/wcs2_0/src/main/java/org/geoserver/wcs2_0/DefaultWebCoverageService20.java`
- [OGC API Coverages](https://github.com/geoserver/geoserver/blob/main/src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java): `src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java`
- [OGC API Features](https://github.com/geoserver/geoserver/blob/main/src/extension/ogcapi/ogcapi-features/src/main/java/org/geoserver/ogcapi/v1/features/FeatureService.java): `src/extension/ogcapi/ogcapi-features/src/main/java/org/geoserver/ogcapi/v1/features/FeatureService.java`
- [Catalog Service](https://github.com/geoserver/geoserver/blob/main/src/extension/csw/core/src/main/java/org/geoserver/csw/DefaultWebCatalogService.java): `src/extension/csw/core/src/main/java/org/geoserver/csw/DefaultWebCatalogService.java`
- [Processing Service](https://github.com/geoserver/geoserver/blob/main/src/community/wps-openai/src/main/java/org/geoserver/llm/cache/LlmCacheManager.java): `src/community/wps-openai/src/main/java/org/geoserver/llm/cache/LlmCacheManager.java`
- [Earth Observation](https://github.com/geoserver/geoserver/blob/main/src/community/oseo/oseo-service/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java): `src/community/oseo/oseo-service/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java`
- [CoverageJSON encoder](https://github.com/geoserver/geoserver/blob/main/src/community/cov-json/src/main/java/org/geoserver/wcs/responses/covjson/Coverage.java): `src/community/cov-json/src/main/java/org/geoserver/wcs/responses/covjson/Coverage.java`

### Catalog and Data

- [Catalog index](https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/catalog/Catalog.java): `src/main/src/main/java/org/geoserver/catalog/Catalog.java`
- [Coverage metadata](https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/catalog/CoverageInfo.java): `src/main/src/main/java/org/geoserver/catalog/CoverageInfo.java`
- [Layer metadata](https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/catalog/LayerInfo.java): `src/main/src/main/java/org/geoserver/catalog/LayerInfo.java`
- [Coverage store](https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/catalog/CoverageStoreInfo.java): `src/main/src/main/java/org/geoserver/catalog/CoverageStoreInfo.java`
- [Server configuration](https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/config/GeoServer.java): `src/main/src/main/java/org/geoserver/config/GeoServer.java`

### Management APIs

- [Coverage REST API](https://github.com/geoserver/geoserver/blob/main/src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java): `src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java`
- [Coverage file API](https://github.com/geoserver/geoserver/blob/main/src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageStoreFileController.java): `src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageStoreFileController.java`
- [REST framework](https://github.com/geoserver/geoserver/blob/main/src/rest/src/main/java/org/geoserver/rest/RestBaseController.java): `src/rest/src/main/java/org/geoserver/rest/RestBaseController.java`

### Security

- [User group service](https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/security/GeoServerUserGroupService.java): `src/main/src/main/java/org/geoserver/security/GeoServerUserGroupService.java`
- [Authorized user groups](https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java): `src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`
- [Authorized roles](https://github.com/geoserver/geoserver/blob/main/src/main/src/main/java/org/geoserver/security/AuthorizingRoleService.java): `src/main/src/main/java/org/geoserver/security/AuthorizingRoleService.java`

### Other components

- **Geospatial client**

## Connections

- Geospatial client → Web Map Service: requests maps (evidence: `README.md`)
- Geospatial client → Web Feature Service: requests features (evidence: `README.md`)
- Geospatial client → Web Coverage Service: requests coverages (evidence: `README.md`)
- Geospatial client → OGC API Coverages: requests coverages (evidence: `README.md`)
- Geospatial client → OGC API Features: requests features (evidence: `README.md`)
- Geospatial client → Catalog Service: searches catalog (evidence: `README.md`)
- Geospatial client → Processing Service: requests processing (evidence: `README.md`)
- Geospatial client → Earth Observation: searches products
- Web Map Service → Geospatial client: publishes maps (evidence: `README.md`)
- Web Feature Service → Geospatial client: publishes features (evidence: `README.md`)
- Web Coverage Service → Geospatial client: publishes coverages (evidence: `README.md`)
- OGC API Features → Geospatial client: publishes features (evidence: `README.md`)
- Catalog Service → Geospatial client: publishes catalog (evidence: `README.md`)
- Processing Service → Geospatial client: returns results (evidence: `README.md`)
- Earth Observation → Geospatial client: returns products (evidence: `src/community/oseo/oseo-service/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java`)
- OGC API Coverages → Web Coverage Service: delegates retrieval (evidence: `src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java`)
- OGC API Coverages → CoverageJSON encoder: formats response
- OGC API Coverages → Catalog index: looks up catalog (evidence: `src/community/ogcapi/ogcapi-coverages/src/main/java/org/geoserver/ogcapi/v1/coverages/CoveragesService.java`)
- Coverage REST API → Catalog index: reads catalog (evidence: `src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java`)
- Coverage file API → Catalog index: updates catalog (evidence: `src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageStoreFileController.java`)
- Coverage REST API → REST framework: extends framework (evidence: `src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java`)
- Coverage file API → REST framework: extends framework (evidence: `src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageStoreFileController.java`)
- Catalog index → Coverage metadata: indexes coverage (evidence: `src/main/src/main/java/org/geoserver/catalog/Catalog.java`)
- Coverage metadata → Coverage store: uses store (evidence: `src/main/src/main/java/org/geoserver/catalog/CoverageInfo.java`)
- Catalog index → Layer metadata: indexes layers (evidence: `src/main/src/main/java/org/geoserver/catalog/Catalog.java`)
- Server configuration → Catalog index: holds catalog (evidence: `src/main/src/main/java/org/geoserver/config/GeoServer.java`)
- User group service → Authorized user groups: wrapped by (evidence: `src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`)
- Authorized user groups → User group service: delegates operations (evidence: `src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`)
