How do I access the tiles from the server? #58

hadjiprocopis · 2025-10-09T13:10:17Z

hadjiprocopis
Oct 9, 2025

I have followed your guide on how to setup the server with OpenStreetMap tiles, and finally I run it with:

...
versatiles convert --bbox-border 3 --bbox "<MYBBOX>" "https://download.versatiles.org/osm.versatiles" "osm.versatiles"

/usr/local/bin/versatiles server --port 5477 --static '/var/www/versatiles/frontend.br.tar.gz' '[osm]/var/www/versatiles/osm.versatiles'
# it tells me this:
#   /tiles/osm/*                    <-  /var/www/versatiles/osm.versatiles
# server starts listening on 0.0.0.0:5477

Great!

Now, what is the endpoint for getting the tiles out?
I tried these:

wget 'http://127.0.0.1:5477/'
# the above returns me an index.html file, great!
# but tiles? this 404's
wget  'http://127.0.0.1:5477/tiles/osm/15/19420/12960'

P.s. note that my tiles are restricted within a bounding box. I use this html to test also:

<!DOCTYPE html>
<html lang="en">
<head>
	<base target="_top">
	<meta charset="utf-8">
	<meta name="viewport" content="width=device-width, initial-scale=1">
	<title>Quick Start - Leaflet</title>
	<link rel="stylesheet" href="https://unpkg.com/maplibre-gl@latest/dist/maplibre-gl.css" />
	<script src="https://unpkg.com/maplibre-gl@latest/dist/maplibre-gl.js"></script>
</head>
<body>

<div id="map" class="maplibregl-compact" style="position:absolute;top:0;bottom:0;width:100%"></div>
<script>
// Define the map syle (OpenStreetMap raster tiles)
const style = {
  "version": 8,
	"sources": {
    "osm": {
"type": "raster",
"tiles": ['http://127.0.0.1:5477/tiles/osm/{z}/{x}/{y}'],
	"tileSize": 256,
      "attribution": "&copy; OpenStreetMap Contributors",
      "maxzoom": 19
    }
  },
  "layers": [
    {
      "id": "osm",
      "type": "raster",
      "source": "osm" // This must match the source key above
    }
  ]
};
// Initialise the map
const map = new maplibregl.Map({
  container: 'map',
  style: style,
       // LON, LAT !!!
  // these are within the bounds of the osm tiles subset fetched
  center: [33.36625903844834, 35.17081341051117],
  zoom: 15
});
// Add the navigation control
map.addControl(new maplibregl.NavigationControl(), 'top-right');
</script>
</body>
</html>

MichaelKreil · 2025-10-09T14:10:38Z

MichaelKreil
Oct 9, 2025
Maintainer

The OSM tiles are not pre-rendered raster tiles, but vector tiles. The style object is quite complex, since it uses over 200 layers (streets, bridges, tunnels, bridges over tunnels, tunnels over bridges , ...).
I would recommend to use the VersaTiles style lib to generate and change the style, like here: https://versatiles.org/playground/basic-style/

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

VersaTiles

How do I access the tiles from the server? #58

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

VersaTiles

How do I access the tiles from the server? #58

Uh oh!

Uh oh!

hadjiprocopis Oct 9, 2025

Replies: 1 comment

Uh oh!

MichaelKreil Oct 9, 2025 Maintainer

hadjiprocopis
Oct 9, 2025

MichaelKreil
Oct 9, 2025
Maintainer