Developer Tools

SDKs & Command Line Interface

Programmatically manage layers, workspaces, styles, and geospatial workflows. Ship faster with native libraries and a zero-config CLI.

Read the Docs API Reference

Installation

Get started in seconds. The CLI and SDKs are distributed via standard package managers.

terminal — npm
$npm install @geoserver/cli @geoserver/js + @geoserver/cli@3.2.1 + @geoserver/js@3.2.1 added 14 packages in 1.8s
terminal — pip
$pip install geo-cli geo-py Collecting geo-cli Downloading geo_cli-3.2.1-py3-none-any.whl (186 kB) Successfully installed geo-cli-3.2.1 geo-py-3.2.1
terminal — go
$go install github.com/geoserver/go-cli/cmd/geoserver-cli@latest go: downloading github.com/geoserver/go-cli v3.2.1 installed: /usr/local/go/bin/geoserver-cli
terminal — docker
$docker pull ghcr.io/geoserver/cli:latest latest: Pulling from geoserver/cli Status: Downloaded newer image for ghcr.io/geoserver/cli:latest Usage: docker run --rm ghcr.io/geoserver/cli [command]

✓ Automatic configuration detected. Run geoserver-cli init to connect to your instance.

CLI Reference

Manage your GeoServer instance entirely from the terminal. Chain commands, script deployments, and automate pipelines.

init Configure Connection

Set up credentials, REST API endpoints, and authentication profiles securely.

geoserver-cli init --endpoint https://api.geo.example --auth admin:pass

layers Manage Datasets

Create, publish, style, and remove vector/raster layers with zero UI interaction.

geoserver-cli layers create ./data.shp --workspace hydro --style blue-fill

auth Roles & Permissions

Provision users, assign roles, and enforce layer-level access control via CLI.

geoserver-cli auth add-role field_ops --layer "field_sensor_data" --grant read,query

export Data Extraction

Pull spatial data in GeoJSON, Shapefile, or GeoPackage formats directly to disk.

geoserver-cli export --layer parcels --format gpkg --output ./exports/

backup & restore

Snapshot configurations, layer definitions, and security settings for DR workflows.

geoserver-cli backup --full --archive ./backups/2024-10-12.tar.gz

ci Pipeline Integration

Headless validation, layer diffing, and deployment status checks for CI/CD.

geoserver-cli ci validate --config ./layers.yaml --strict

Official SDKs

Native libraries built for type safety, async/await patterns, and seamless integration with modern ecosystems.

🐍

Python SDK

Data science & geospatial workflows. Pandas/GeoPandas compatible with lazy evaluation.

geo-py
Docs API
⚡

TypeScript / Node.js

Full type coverage, ESM/CJS support, and streaming tile generation for web apps.

@geoserver/js
Docs API
🔷

Go SDK

High-performance concurrent spatial queries. Ideal for microservices and edge deployments.

github.com/geoserver/go-sdk
Docs API
☕

Java SDK

Enterprise-grade integration for Spring Boot, Jakarta EE, and legacy GIS stacks.

io.geoserver:core
Docs API

Build on Top of GeoServer

Access the full OGC stack (WMS, WFS, WCS, TMS) plus custom REST endpoints, webhook triggers, and batch processing queues.

Join Developer Program