I'm creating a webmap, and hoping to add a few basemap/raster layers of my own. I'll be using a stack that includes GeoServer which is fine for vector data, but I'd like to serve the new basemap layers through GeoServer as well, and I'm having trouble finding the best way to do that. I'd like to use .mbtiles files that I create with TileMill, because they look good and are easy to style. The goal is to create a WMS from these tiles.

I've added the MBTiles plugin to my GeoServer 2.6.1 installation on an Amazon EC2 instance, and transferred the .mbtiles file to the GeoServer data directory. However, when I go to add the new MBTiles data store, it seems to create a data store, but when I try to create a new layer using that data store, the interface doesn't respond. It's as if GeoServer doesn't recognize the MBTiles data store correctly.

I'm very new to this, so I'm probably missing something, but I've read a lot of documentation and can't figure it out.

  • Did you use the mbtiles plugin that matches geoserver 2.6.1? If you followed the link instructions in the documentation, it might have taken you to the nightly builds, which isn't what you want.
    – BradHards
    Dec 28, 2014 at 1:24
  • Thanks for your suggestion! I had used the correct version, but when I was reinstalling the extension I realized that I had not copied all of the contents of the zip to the server, only one of them. Now everything is fine. I'm not sure the best way to mark this question answered, or if I should. Thanks again.
    – mr.adam
    Dec 29, 2014 at 15:39

1 Answer 1


To summarise the discussion:

  • When adding extensions (including community modules) to GeoServer, it is very important to use the version of the extension that matches the build of GeoServer. Don't use an earlier or later version, even if there is a link in the documentation that suggests using "nightly" builds of an extension on a stable / released GeoServer.

  • The zip file version of the extension should contain the required dependencies for that module. You need to install all of those (unless, of course, you already have the dependency installed, e.g. from installing another extension that had some of the same dependencies).

  • There are a couple of special cases, where one extension requires another extension. An example is that the GeoPackage community module requires the WPS extension. You should check the documentation for the module you're installing in case it has special cases like this.

The distinction between extensions and community modules is really about how it is supported, and doesn't suggest different interfaces or other technical differences. Installation follows the same rules.

  • 1
    thanks, and for newbies like myself, installing just means placing the .jar files into the correct folder in the geoserver installation, which in my case is /var/lib/tomcat7/webapps/geoserver/WEB-INF/lib
    – mr.adam
    Jan 7, 2015 at 14:53

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.