# moustafa-ai/geoserver architecture

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

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

## Overview

GeoServer is a Java geospatial server for publishing and editing spatial data through OGC services. The principal workflow is a client request reaching a service endpoint, which obtains configured data or catalog information and returns a standards-based response. The repository also contains REST catalog management, an ArcGIS-style query endpoint, Earth Observation search, and security services. The map emphasizes these documented capabilities and core catalog, configuration, and security modules. Several modules are represented from the source index or tree only; their internal connections are omitted where the excerpts do not establish them.

Main entry points: [`src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java) (Group authorization), [`src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java`](https://github.com/moustafa-ai/geoserver/blob/master/src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java) (Coverage REST), [`src/main/src/main/java/org/geoserver/config/GeoServer.java`](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/config/GeoServer.java) (Server configuration), [`src/main/src/main/java/org/geoserver/catalog/Catalog.java`](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/catalog/Catalog.java) (Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Request entry points"]
  node_coverage["Coverage REST"]
  node_gsr["Map query API"]
end

subgraph group_services["Geospatial services"]
  node_wms["WMS service"]
  node_wfs["WFS service"]
  node_wcs10["WCS 1.0"]
  node_wcs11["WCS 1.1"]
  node_wcs20["WCS 2.0"]
  node_csw["CSW service"]
  node_wps["WPS service"]
end

subgraph group_catalog["Catalog and configuration"]
  node_catalog[("Catalog<br/>[Catalog.java]")]
  node_coverageinfo["Coverage metadata<br/>[CoverageInfo.java]"]
  node_geoserver["Server configuration<br/>[GeoServer.java]"]
  node_persister["Config persister"]
  node_extensions["Extension registry"]
  node_serviceexception["Service errors"]
end

subgraph group_security["Security"]
  node_usergroupservice["User group service"]
  node_usergroupstore["User group store"]
  node_namedconfig["Security config"]
  node_loadedlistener["Load listener"]
  node_user["User identity<br/>[GeoServerUser.java]"]
  node_usergroup["User group"]
  node_roleauth["Role authorization"]
  node_groupauth["Group authorization"]
end

subgraph group_extensions["Extensions"]
  node_oseo["EO search"]
  node_envelope["Spatial envelope<br/>[Envelope.java]"]
  node_stringutils["WCS utilities<br/>[StringUtils.java]"]
end

node_client(("Client"))

node_client -->|"requests maps"| node_wms
node_client -->|"requests features"| node_wfs
node_client -->|"requests coverage"| node_wcs10
node_client -->|"requests coverage"| node_wcs11
node_client -->|"requests coverage"| node_wcs20
node_client -->|"queries catalog"| node_csw
node_client -->|"requests processing"| node_wps
node_client -.->|"manages coverage"| node_coverage
node_client -->|"queries map layer"| node_gsr
node_coverage -->|"looks up coverage"| node_catalog
node_gsr -->|"receives configuration"| node_geoserver
node_wcs11 -->|"uses catalog"| node_catalog
node_geoserver -->|"exposes catalog"| node_catalog
node_coverage -->|"returns coverage"| node_coverageinfo
node_groupauth -->|"delegates to"| node_usergroupservice
node_groupauth -->|"writes through"| node_usergroupstore
node_groupauth -->|"filters users"| node_user
node_groupauth -->|"filters groups"| node_usergroup
node_groupauth -->|"uses listener"| node_loadedlistener
node_oseo -->|"reads configuration"| node_geoserver
node_oseo -->|"uses geometry"| node_envelope

click node_wms "https://github.com/moustafa-ai/geoserver/blob/master/src/wms/src/main/java/org/geoserver/wms/DefaultWebMapService.java"
click node_wfs "https://github.com/moustafa-ai/geoserver/blob/master/src/wfs/src/main/java/org/geoserver/wfs/DefaultWebFeatureService.java"
click node_wcs10 "https://github.com/moustafa-ai/geoserver/blob/master/src/wcs1_0/src/main/java/org/geoserver/wcs/DefaultWebCoverageService100.java"
click node_wcs11 "https://github.com/moustafa-ai/geoserver/blob/master/src/wcs1_1/src/main/java/org/geoserver/wcs/DefaultWebCoverageService111.java"
click node_wcs20 "https://github.com/moustafa-ai/geoserver/blob/master/src/wcs2_0/src/main/java/org/geoserver/wcs2_0/DefaultWebCoverageService20.java"
click node_csw "https://github.com/moustafa-ai/geoserver/blob/master/src/extension/csw/core/src/main/java/org/geoserver/csw/DefaultWebCatalogService.java"
click node_wps "https://github.com/moustafa-ai/geoserver/blob/master/src/extension/wps/wps-core/src/main/java/org/geoserver/wps/DefaultWebProcessingService.java"
click node_coverage "https://github.com/moustafa-ai/geoserver/blob/master/src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java"
click node_gsr "https://github.com/moustafa-ai/geoserver/blob/master/src/community/gsr/src/main/java/org/geoserver/gsr/api/map/QueryController.java"
click node_catalog "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/catalog/Catalog.java"
click node_coverageinfo "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/catalog/CoverageInfo.java"
click node_geoserver "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/config/GeoServer.java"
click node_persister "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/config/util/XStreamPersister.java"
click node_extensions "https://github.com/moustafa-ai/geoserver/blob/master/src/platform/src/main/java/org/geoserver/platform/GeoServerExtensions.java"
click node_serviceexception "https://github.com/moustafa-ai/geoserver/blob/master/src/platform/src/main/java/org/geoserver/platform/ServiceException.java"
click node_usergroupservice "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/GeoServerUserGroupService.java"
click node_usergroupstore "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/GeoServerUserGroupStore.java"
click node_namedconfig "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/config/SecurityNamedServiceConfig.java"
click node_loadedlistener "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/event/UserGroupLoadedListener.java"
click node_user "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/impl/GeoServerUser.java"
click node_usergroup "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/impl/GeoServerUserGroup.java"
click node_roleauth "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/AuthorizingRoleService.java"
click node_groupauth "https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java"
click node_oseo "https://github.com/moustafa-ai/geoserver/blob/master/src/community/oseo/oseo-core/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java"
click node_envelope "https://github.com/moustafa-ai/geoserver/blob/master/src/community/gsr/src/main/java/org/geoserver/gsr/model/geometry/Envelope.java"
click node_stringutils "https://github.com/moustafa-ai/geoserver/blob/master/src/wcs2_0/src/main/java/org/geoserver/wcs2_0/util/StringUtils.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_coverage,node_gsr,node_client toneBlue
class node_wms,node_wfs,node_wcs10,node_wcs11,node_wcs20,node_csw,node_wps toneAmber
class node_catalog,node_coverageinfo,node_geoserver,node_persister,node_extensions,node_serviceexception toneMint
class node_usergroupservice,node_usergroupstore,node_namedconfig,node_loadedlistener,node_user,node_usergroup,node_roleauth,node_groupauth toneRose
class node_oseo,node_envelope,node_stringutils toneIndigo
```

## Components

### Request entry points

- [Coverage REST](https://github.com/moustafa-ai/geoserver/blob/master/src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java): `src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java`
- [Map query API](https://github.com/moustafa-ai/geoserver/blob/master/src/community/gsr/src/main/java/org/geoserver/gsr/api/map/QueryController.java): `src/community/gsr/src/main/java/org/geoserver/gsr/api/map/QueryController.java`

### Geospatial services

- [WMS service](https://github.com/moustafa-ai/geoserver/blob/master/src/wms/src/main/java/org/geoserver/wms/DefaultWebMapService.java): `src/wms/src/main/java/org/geoserver/wms/DefaultWebMapService.java`
- [WFS service](https://github.com/moustafa-ai/geoserver/blob/master/src/wfs/src/main/java/org/geoserver/wfs/DefaultWebFeatureService.java): `src/wfs/src/main/java/org/geoserver/wfs/DefaultWebFeatureService.java`
- [WCS 1.0](https://github.com/moustafa-ai/geoserver/blob/master/src/wcs1_0/src/main/java/org/geoserver/wcs/DefaultWebCoverageService100.java): `src/wcs1_0/src/main/java/org/geoserver/wcs/DefaultWebCoverageService100.java`
- [WCS 1.1](https://github.com/moustafa-ai/geoserver/blob/master/src/wcs1_1/src/main/java/org/geoserver/wcs/DefaultWebCoverageService111.java): `src/wcs1_1/src/main/java/org/geoserver/wcs/DefaultWebCoverageService111.java`
- [WCS 2.0](https://github.com/moustafa-ai/geoserver/blob/master/src/wcs2_0/src/main/java/org/geoserver/wcs2_0/DefaultWebCoverageService20.java): `src/wcs2_0/src/main/java/org/geoserver/wcs2_0/DefaultWebCoverageService20.java`
- [CSW service](https://github.com/moustafa-ai/geoserver/blob/master/src/extension/csw/core/src/main/java/org/geoserver/csw/DefaultWebCatalogService.java): `src/extension/csw/core/src/main/java/org/geoserver/csw/DefaultWebCatalogService.java`
- [WPS service](https://github.com/moustafa-ai/geoserver/blob/master/src/extension/wps/wps-core/src/main/java/org/geoserver/wps/DefaultWebProcessingService.java): `src/extension/wps/wps-core/src/main/java/org/geoserver/wps/DefaultWebProcessingService.java`

### Catalog and configuration

- [Catalog](https://github.com/moustafa-ai/geoserver/blob/master/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/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/catalog/CoverageInfo.java): `src/main/src/main/java/org/geoserver/catalog/CoverageInfo.java`
- [Server configuration](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/config/GeoServer.java): `src/main/src/main/java/org/geoserver/config/GeoServer.java`
- [Config persister](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/config/util/XStreamPersister.java): `src/main/src/main/java/org/geoserver/config/util/XStreamPersister.java`
- [Extension registry](https://github.com/moustafa-ai/geoserver/blob/master/src/platform/src/main/java/org/geoserver/platform/GeoServerExtensions.java): `src/platform/src/main/java/org/geoserver/platform/GeoServerExtensions.java`
- [Service errors](https://github.com/moustafa-ai/geoserver/blob/master/src/platform/src/main/java/org/geoserver/platform/ServiceException.java): `src/platform/src/main/java/org/geoserver/platform/ServiceException.java`

### Security

- [User group service](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/GeoServerUserGroupService.java): `src/main/src/main/java/org/geoserver/security/GeoServerUserGroupService.java`
- [User group store](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/GeoServerUserGroupStore.java): `src/main/src/main/java/org/geoserver/security/GeoServerUserGroupStore.java`
- [Security config](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/config/SecurityNamedServiceConfig.java): `src/main/src/main/java/org/geoserver/security/config/SecurityNamedServiceConfig.java`
- [Load listener](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/event/UserGroupLoadedListener.java): `src/main/src/main/java/org/geoserver/security/event/UserGroupLoadedListener.java`
- [User identity](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/impl/GeoServerUser.java): `src/main/src/main/java/org/geoserver/security/impl/GeoServerUser.java`
- [User group](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/impl/GeoServerUserGroup.java): `src/main/src/main/java/org/geoserver/security/impl/GeoServerUserGroup.java`
- [Role authorization](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/AuthorizingRoleService.java): `src/main/src/main/java/org/geoserver/security/AuthorizingRoleService.java`
- [Group authorization](https://github.com/moustafa-ai/geoserver/blob/master/src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java): `src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`

### Extensions

- [EO search](https://github.com/moustafa-ai/geoserver/blob/master/src/community/oseo/oseo-core/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java): `src/community/oseo/oseo-core/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java`
- [Spatial envelope](https://github.com/moustafa-ai/geoserver/blob/master/src/community/gsr/src/main/java/org/geoserver/gsr/model/geometry/Envelope.java): `src/community/gsr/src/main/java/org/geoserver/gsr/model/geometry/Envelope.java`
- [WCS utilities](https://github.com/moustafa-ai/geoserver/blob/master/src/wcs2_0/src/main/java/org/geoserver/wcs2_0/util/StringUtils.java): `src/wcs2_0/src/main/java/org/geoserver/wcs2_0/util/StringUtils.java`

### Other components

- **Client**

## Connections

- Client → WMS service: requests maps
- Client → WFS service: requests features
- Client → WCS 1.0: requests coverage
- Client → WCS 1.1: requests coverage
- Client → WCS 2.0: requests coverage
- Client → CSW service: queries catalog
- Client → WPS service: requests processing
- Client → Coverage REST: manages coverage
- Client → Map query API: queries map layer (evidence: `src/community/gsr/src/main/java/org/geoserver/gsr/api/map/QueryController.java`)
- Coverage REST → Catalog: looks up coverage (evidence: `src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java`)
- Map query API → Server configuration: receives configuration (evidence: `src/community/gsr/src/main/java/org/geoserver/gsr/api/map/QueryController.java`)
- WCS 1.1 → Catalog: uses catalog (evidence: `src/wcs1_1/src/main/java/org/geoserver/wcs/DefaultWebCoverageService111.java`)
- Server configuration → Catalog: exposes catalog (evidence: `src/main/src/main/java/org/geoserver/config/GeoServer.java`)
- Coverage REST → Coverage metadata: returns coverage (evidence: `src/restconfig/src/main/java/org/geoserver/rest/catalog/CoverageController.java`)
- Group authorization → User group service: delegates to (evidence: `src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`)
- Group authorization → User group store: writes through (evidence: `src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`)
- Group authorization → User identity: filters users (evidence: `src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`)
- Group authorization → User group: filters groups (evidence: `src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`)
- Group authorization → Load listener: uses listener (evidence: `src/main/src/main/java/org/geoserver/security/AuthorizingUserGroupService.java`)
- EO search → Server configuration: reads configuration (evidence: `src/community/oseo/oseo-core/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java`)
- EO search → Spatial envelope: uses geometry (evidence: `src/community/oseo/oseo-core/src/main/java/org/geoserver/opensearch/eo/DefaultOpenSearchEoService.java`)
