Publishing a Image

This tutorial walks through the steps of publishing a World + Image with GeoServer.


This tutorial assumes that GeoServer is running at http://localhost:8080/geoserver.

Data preparation

First let’s gather that the data that we’ll be publishing.

  1. Download the Natural Earth 1:50m Shaded Relief raster:

  2. This file contains small scale 1:50m data:

    • SR_50M.prj

    • SR_50M.README.html

    • SR_50M.tfw

    • SR_50M.tif

    • SR_50M.VERSION.txt

    This forms a world (the tfw file) plus image (the tif file).

  3. Move these files into your GeoServer Data Directory data/ne folder.

Creating a new workspace

The next step is to create a workspace for the geopackage. A workspace is a folder used to group similar layers together.


This step is optional if you’d like to use an existing workspace. Usually, a workspace is created for each project, which can include stores and layers that are related to each other.

  1. In a web browser, navigate to http://localhost:8080/geoserver.

  2. Log into GeoServer as described in the Logging In section.

  3. Navigate to Data ‣ Workspaces.

  4. Click the Add new workspace button to display the New Workspace page.

  5. You will be prompted to enter a workspace Name and Namespace URI.



    Namespace URI



    A workspace name is an identifier describing your project. It must not exceed ten characters or contain spaces.


    A Namespace URI (Uniform Resource Identifier) can usually be a URL associated with your project with an added trailing identifier indicating the workspace. The Namespace URI filed does not need to resolve to an actual valid web address.

  6. Press the Submit button.

  7. The tutorial workspace will be added to the Workspaces list.

Create a store

Once the workspace is created, we are ready to add a new store. The store tells GeoServer how to connect to the geopackage.

  1. Navigate to Data‣Stores.

  2. This page displays a list of stores, including the type of store and the workspace that the store belongs to.

  3. In order to add the geopackage, you need to create a new store. Click the Add new Store button. You will be redirected to a list of the data sources supported by GeoServer. Note that the data sources are extensible, so your list may look slightly different.

  4. From the list of Raster Data Sources locate and click the WorldImage link.


    Raster Data Sources

  5. The New Vector Data Source page will display.

  6. Begin by configuring the Basic Store Info.



    Data Source Name



    Grayscale shaded relief of land areas.

    This information is internal to GeoServer and is not used as part of the web service protocols. We recommend keeping the Data Source Name simple as they will be used to form folders in the data directory (so keep any operating system restrictions on character use in mind).


    Basic Store info

  7. Connection parameters are used to establish the location of your data.

  8. Under Connection Parameters, browse to the location URL of the image, in our example file:data/ne/SR_50M.tif.

  9. The Connection Parameters for our geopackage are:



    The use of read_only above indicates that we will not be writing to this GeoPackage, allowing GeoServer to avoid managing write locks when accessing this content for greater performance.


    Connection Parameters

  10. Press Save.

  11. You will be redirected to the New Layer page (as this is the most common next step when adding a new data store).

Creating a layer

Now that we have located the image, we can publish this information as a layer.

  1. On the New Layer page, click Publish beside the SR_50M layer name.

  2. The Edit Layer page defines the data and publishing parameters for a layer.

  3. There are three critical pieces of information required on the Data tab before we can even save.

    • Basic Resource Info - describes how the layer is presented to others

    • Coordinate Reference System - establishes how the spatial data is to be interpreted or drawn on the world

    • Bounding Boxes - establishes where the dataset is located in the world

  4. Locate Basic Resource Info and define the layer:




    Shaded Relief


    Grayscale shaded relief of land areas.

    The naming of a layer is important, and while GeoServer does not offer restrictions many of the individual protocols will only work with very simple names.


    Basic Resource Info

  5. Check the Coordiante Reference Systems information is as listed below.


    In this case select Force declared to prefer the GeoServer internal EPSG database definition of WGS84 over the prj file provided alongside the same image.

    Native SRS


    Declaired SRS


    SRS Handling

    Force declared


    Coordinate Reference Systems

  6. Locate Bounding Boces and generate the layer’s bounding boxes by clicking the Compute from SRS bounds and then Compute from native bounds links.


    In this case we are choosing a slightly larger bounding box that fully contains the image.


    Generating bounding boxes

  7. Press Apply to save your work thus far without closing the page.

    This is a good way to check that your information has been entered correctly, GeoServer will provide a warning if any required information is incomplete.

  8. Scroll to the top of the page and navigate to the Publishing tab.

  9. Locate the WMS Settings heading, where we can set the style.Ensure that the Default Style is set to raster.


    WMS Settings

  10. Press Save to complete your layer edits.

Previewing the layer

In order to verify that the tutorial:shaded layer is published correctly, we can preview the layer.

  1. Navigate to the Data > Layer Preview page and find the tutorial:shaded layer.


    Use the Search field with tutorial as shown to limit the number of layers to page through.

  2. Click the OpenLayers link in the Common Formats column.

  3. An OpenLayers map will load in a new tab and display the imagery with the default raster style.

    You can use this preview map to zoom and pan around the dataset, as well as display the attributes of features.


    Preview map of shaded relief