Layer Commands#

Configure GeoServer layers after they’ve been published. Layers represent published feature types or coverages.

Update Layer#

Update layer configuration including default style, enabled status, and advertisement in capabilities.

Set Default Style#

1
./geoserver-cli layer update my_layer --default-style my_style

Enable/Disable Layer#

1
2
3
4
5
# Enable layer
./geoserver-cli layer update my_layer --enabled true

# Disable layer
./geoserver-cli layer update my_layer --enabled false

Control Advertisement#

1
2
3
4
5
# Advertise in capabilities
./geoserver-cli layer update my_layer --advertised true

# Hide from capabilities
./geoserver-cli layer update my_layer --advertised false

Multiple Updates#

1
2
3
4
./geoserver-cli layer update my_layer \
  --default-style my_style \
  --enabled true \
  --advertised true

View Current Configuration#

1
2
# Show current layer configuration (no flags)
./geoserver-cli layer update my_layer

Output:

1
2
3
4
5
Current layer configuration:
  Name: my_layer
  Default Style: my_style
  Enabled: true
  Advertised: true

Layer Properties#

Enabled#

When a layer is enabled, it can be accessed via WMS/WFS requests. Disabled layers return errors.

Advertised#

When a layer is advertised, it appears in GetCapabilities responses. Non-advertised layers are hidden but can still be accessed if you know the layer name.

Default Style#

The default style is used when no style is specified in WMS requests.

Examples#

Post-Publish Configuration#

1
2
3
4
5
6
7
8
9
# 1. Publish layer from PostGIS
./geoserver-cli publish postgis --layer roads -w my_workspace --store postgis

# 2. Create and apply style
./geoserver-cli style create road_style --sld @road.sld
./geoserver-cli layer update roads --default-style road_style

# 3. Enable and advertise
./geoserver-cli layer update roads --enabled true --advertised true

Hide Layer from Capabilities#

1
2
# Layer exists but won't appear in GetCapabilities
./geoserver-cli layer update internal_layer --advertised false

Temporarily Disable Layer#

1
2
3
4
5
# Disable without deleting
./geoserver-cli layer update problematic_layer --enabled false

# Re-enable later
./geoserver-cli layer update problematic_layer --enabled true

Batch Layer Configuration#

1
2
3
4
# Apply style to multiple layers
for layer in roads buildings water; do
  ./geoserver-cli layer update ${layer} --default-style standard_style
done