CLI Reference

Authentication

geoserver login

Authenticate with your GeoServer workspace and store a local session token.

Stable

geoserver login [workspace] [flags]

Flag	Description
`-u, --user`	Username for workspace authentication
`-p, --password`	API key or password (prompts if omitted)
`--env`	Target environment (dev, staging, prod)

Example

geoserver login mapping-prod -u admin --env production

geoserver logout

Clear locally stored authentication tokens and session data.

Stable

geoserver logout [flags]

Flag	Description
`--all`	Clear tokens for all configured workspaces

Example

geoserver logout --all

Projects & Workspaces

geoserver project create

Initialize a new geospatial project with default layer groups and rendering configs.

Stable

geoserver project create [name] [flags]

Flag	Description
`--template`	Project template (base-map, vector-tiles, raster-pipeline)
`--workspace`	Target workspace ID
`--srs`	Default coordinate reference system (e.g., EPSG:4326)

Example

geoserver project create us-transport --template vector-tiles --srs EPSG:3857

geoserver project list

Display all active projects with status, layer count, and storage usage.

Stable

geoserver project list [flags]

Flag	Description
`--json`	Output results in JSON format
`--status`	Filter by status (active, paused, syncing)

Example

geoserver project list --status active --json

Deployment & Layers

geoserver deploy

Publish configured layers, styles, and services to the target environment.

Stable

geoserver deploy [project] [flags]

Flag	Description
`--force`	Overwrite existing layers without confirmation
`--dry-run`	Validate deployment config without pushing changes
`--layers`	Comma-separated list of specific layers to deploy

Example

geoserver deploy urban-planning --layers roads,buildings,parcels

geoserver rollback

Revert layers and configurations to a previous deployment version.

Stable

geoserver rollback [project] [flags]

Flag	Description
`--version`	Specific deployment hash or timestamp to revert to
`--confirm`	Skip interactive confirmation prompt

Example

geoserver rollback urban-planning --version v2.4.1 --confirm

Data Ingestion & Sync

geoserver data ingest

Import spatial datasets (GeoJSON, Shapefile, GeoTIFF, PostGIS) into the workspace.

Stable

geoserver data ingest [path] [flags]

Flag	Description
`--format`	Source format override (geojson, shp, tif, pg)
`--srs`	Input coordinate reference system
`--batch`	Process large files in chunks for memory efficiency

Example

geoserver data ingest ./satellite/radar_2024.tif --format tif --batch

geoserver data sync

Update existing layers with new data from connected sources or scheduled pipelines.

Stable

geoserver data sync [layer-id] [flags]

Flag	Description
`--full`	Replace entire dataset instead of incremental update
`--wait`	Block until sync completes and validate checksums

Example

geoserver data sync layer-8f2a --wait

Configuration & Status

geoserver config set

Update instance settings, cache policies, and OGC service parameters.

Stable

geoserver config set [key] [value] [flags]

Flag	Description
`--global`	Apply setting across all workspaces
`--reload`	Trigger service restart after applying changes

Example

geoserver config set wms.max_width 4096 --reload

geoserver status

Check system health, active connections, layer render counts, and cache hit rates.

Stable

geoserver status [flags]

Flag	Description
`--verbose`	Show detailed node metrics and thread pools
`--watch`	Stream live metrics to terminal

Example

geoserver status --watch