NOTICE: is no longer in use from 1st March 2024. Please use the OpenStreetMap Community Forum

I'm very new and very confused about how to accomplish a seemingly simple task: generate my own OSM .png tiles for offline use. Since I want to be able to have a huge amount of tiles, I don't want to load the server by downloading tiles directly from

I was using Creating your own tiles, but learned that this method is outdated with the new styling method: mapnik-stylesheets issue #15

Since this is all new to me, I'm quite confused at the sheer number of methods and tools I've seen recommended to download, format, and render OSM tiles. As far as my progress, here are the steps I have taken:

  1. Created a Postgres database named gis, enabling the postgis and hstore extensions
  2. Downloaded arizona-latest.osm.pbf from
  3. Used osm2pgsql to import arizona-latest.osm.pbf into the Postgres database gis: osm2pgsql -G --hstore --style --tag-transform-script openstreetmap-carto.lua -d gis --slim --flat-nodes /home/user/nodes.cache --cache 5000 /home/user/downloads/arizona-latest.osm.pbf
  4. Generated shapefiles using scripts/ in the openstreetmap-carto directory
  5. Created osm.xml by running carto project.mml > osm.xml
  6. Successfully generated an image using from the outdated mapnik-stylesheets with warnings about failing to understand the new carto xml format.
  7. Failed to generate tiles using from the outdated mapnik-stylesheets with the same errors from

I'm at a loss at where to go from here with my current understanding of how this all works. If anyone can point me in the right direction, I'd greatly appreciate it.

asked 13 Jul '19, 00:23

Karmic%20Creditor's gravatar image

Karmic Creditor
accept rate: 0%

What I'd suggest is:

The problem with is that it'll complain about unused font definitions in the stylesheet.

Edit: As noted below this will generate metatiles, not .png tiles, which probably isn't the best route here.

permanent link

answered 13 Jul '19, 00:41

SomeoneElse's gravatar image

SomeoneElse ♦
accept rate: 16%

edited 13 Jul '19, 11:09


I did have to edit the osm.xml to remove all fonts except Deja Vu Sans because of the complaining. The errors/warnings I get when running the scripts are similar to attribute 'maximum-scale-denominator' with value '100000' at line 0, which, if I understand correctly, is because of the new styles used by OSM. I will try your method and report back.

(13 Jul '19, 00:58) Karmic Creditor


The method you suggested works great. One thing I'm curious about is the diary entry you mentioned. When calling render_list, it seems to create .meta files. Does this produce .png files somewhere I'm not looking?

(13 Jul '19, 06:01) Karmic Creditor

.meta files are containers that contain 64 PNG files each. To extract .png from .meta, either run mod_tile in your Apache web server and run lots and lots of "wget" or "curl" commands against your own web server, or use to go from meta to png without mod_tile/Apache.

(13 Jul '19, 10:01) Frederik Ramm ♦

It sounds like you're nearly there - just one comment about "I did have to edit the osm.xml to remove all fonts except Deja Vu Sans because of the complaining":

You might find it easier to edit the stylesheet (the thing you run "carto" on) rather than editing the generated .xml directly. If you can find out what's causing the problem you can probably edit it out in one place in a .mss file rather than many from the generated .xml.

(13 Jul '19, 11:15) SomeoneElse ♦

Thank you two for the help. I will use meta2tile when the render_list completes

(13 Jul '19, 12:14) Karmic Creditor

(Two years later) You could also use my beefed up version of

permanent link

answered 15 Mar '21, 20:38

Marcos%20Dione's gravatar image

Marcos Dione
accept rate: 0%

Follow this question

By Email:

Once you sign in you will be able to subscribe for any updates here



Answers and Comments

Markdown Basics

  • *italic* or _italic_
  • **bold** or __bold__
  • link:[text]( "title")
  • image?![alt text](/path/img.jpg "title")
  • numbered list: 1. Foo 2. Bar
  • to add a line break simply add two spaces to where you would like the new line to be.
  • basic HTML tags are also supported

Question tags:


question asked: 13 Jul '19, 00:23

question was seen: 14,732 times

last updated: 15 Mar '21, 20:38

NOTICE: is no longer in use from 1st March 2024. Please use the OpenStreetMap Community Forum