Step-by-Step Guide: Download, Configure, and Publish a Shapefile with GeoServer

Download and start GeoServer

Open the official site http://geoserver.org/, click the **Stable** version link, and download the binary distribution (or the WAR file for Tomcat).

Extract the archive. Edit start.ini in the extracted directory, change the line jetty.port=8080 to the desired port, e.g., jetty.port=8000.

Run bin/startup.bat (Windows) or the equivalent script on other platforms. Keep the console window open; a clean start indicates the server is running.

Open a browser and navigate to http://localhost:8000/geoserver. Log in with the default credentials admin / geoserver.

Prepare shapefile data

Download the example dataset nyc_roads.zip from

https://docs.geoserver.org/stable/en/user/_downloads/30e405b790e068c43354367cb08e71bc/nyc_roads.zip

.

Unzip the archive; it contains nyc_roads.shp, nyc_roads.shx, nyc_roads.dbf, and nyc_roads.prj.

Move the entire nyc_roads directory into the GeoServer data directory under <GEOSERVER_DATA_DIR>/data/nyc_roads (default path geoserver/data_dir/data/nyc_roads).

Create a workspace

In the GeoServer web UI, go to Data → Workspaces and click **Add new workspace**.

Enter a short name, e.g., nyc, and a Namespace URI such as http://geoserver.org/nyc. The name must be ≤10 characters and contain no spaces.

Optionally set the workspace as the default and click **Submit**.

Create a shapefile store

Navigate to Data → Stores and click **Add new Store**.

Select **Shapefile** as the data source type.

Configure the store:

Select the nyc workspace.

Set **Data Source Name** to NYC Roads.

Provide a description, e.g., “Roads in New York City”.

Under **Connection Parameters**, browse to the shapefile location nyc_roads/nyc_roads.shp.

Click **Save**; the UI redirects to the **New Layer** page for nyc_roads.

Publish the layer

On the **New Layer** page, click **Publish** next to nyc_roads.

Enter a short **Title** and an **Abstract** for the layer.

Generate bounding boxes by clicking **Compute from data** and then **Compute from native bounds**.

Switch to the **Publishing** tab and ensure the **Default Style** under WMS Settings is set to line.

Click **Save** to finalize the layer configuration.

Preview the layer

Open **Layer Preview**, locate the layer nyc:nyc_roads, and click the **OpenLayers** link in the *Common Formats* column.

An OpenLayers map loads in a new tab, displaying the roads with the default line style.

The WMS endpoint http://localhost:8000/geoserver/nyc/wms can be used as a data source for front‑end mapping libraries such as OpenLayers.