Structure of the GeoServer Data Directory¶
The following is the GEOSERVER_DATA_DIR structure:
data_directory/
coverages/
data/
demo/
gwc/
gwc-layers/
layergroups/
logs/
palettes/
security/
styles/
temp/
user_projections/
validation/
workspaces/
www/
global.xml
gwc-gs.xml
logging.xml
wcs.xml
wfs.xml
wms.xml
wps.xml
File | Description |
coverages |
Contains some demo raster layers for this training |
data |
Not to be confused with the GeoServer data directory itself, the data directory is a location where actual data can be stored. This directory is commonly used to store shapefiles and raster files but can be used for any data that is file based. The main benefit of storing data files inside of the data directory is portability. |
demo |
The demo directory contains files which define the sample requests available in the Sample Request Tool. |
gwc |
This directory holds the cache created by the embedded GeoWebCache service. |
gwc-layers |
This directory holds the configuration files created by the embedded GeoWebCache service for each layer. |
layergroups |
Contains information on the layer groups configurations. |
logs |
This directory contains the GeoServer logging files (log file and logging properties files). |
palettes |
The palettes directory is used to store pre-computed Image Palettes. Image palettes are used by the GeoServer WMS as way to reduce the size of produced images while maintaining image quality. |
security |
The security directory contains all the files used to configure the GeoServer security subsystem. This includes a set of property files which define access roles, along with the services and data each role is authorized to access. |
styles |
The styles directory contains a number of Styled Layer Descriptor (SLD) files which contain styling information used by the GeoServer WMS. |
temp |
Temporary directory, used by the WPS service. |
user_projections |
The user_projections directory contains extra spatial reference system definitions. The epsg.properties can be used to add new spatial reference systems, whilst the epsg_override.properties file can be used to override an official definition with a custom one. |
validation |
This directory contains the validation rules |
workspaces |
The various workspaces directories contain metadata about stores and layers which are published by GeoServer. Each layer will have a layer.xml file associated with it, as well as either a coverage.xml or a featuretype.xml file depending on whether it’s a raster or vector. |
www |
The www directory is used to allow GeoServer to act like a regular web server and serve regular files. While not a replacement for a full blown web server the www directory can be useful to easily serve OpenLayers map applications (this avoids the need to setup a proxy in order to respect the same origin policy). |
global.xml |
Contains settings that go across services, including contact information, JAI settings, character sets and verbosity. |
gwc-gs.xml |
Contains various settings for the GeoWebCache service. |
logging.xml |
Specifies the logging level, location, and whether it should log to std out. |
wcs.xml |
Contains the service metadata and various settings for the WCS service. |
wfs.xml |
Contains the service metadata and various settings for the WFS service. |
wms.xml |
Contains the service metadata and various settings for the WMS service. |