Replies: 10 comments 10 replies
-
|
Yes please add at least a link to a source where we can download these pmtiles files |
Beta Was this translation helpful? Give feedback.
-
|
you can dowload mbtiles files here https://www.limaps.org/tileserver.html and then convert them to pmtiles eg. with tilemaker. |
Beta Was this translation helpful? Give feedback.
-
|
Brilliant instructions...
Its busy doing something! Fans screaming :) Old NUC i5 2 core (32gb RAM)
…On Wed, Mar 18, 2026 at 2:34 PM travelingnomad1 ***@***.***> wrote:
I am currently downloading osm.pbf maps myself from
https://download.geofabrik.de/ and converting them (process below). I am
happy to share countries, but have no write access for the map repository
project-nomad-maps, but if you or others do some, too, we could share the
load and split up, so not 10 people convert the same country for themselves.
Currently I finished: *Albania, Andorra, Austria, Azores, Belarus,
Belgium, Bosnia-Herzegovina, Bulgaria, Denmark, Iceland, Greenland,
Liechtenstein and Luxembourg.* If you need some of these, let me know and
I will find a place to upload.
Here is an example of how I do it. I Use Australia for example, but if you
want a quick check if things are working, try a smaller country like Monaco
or the Azores islands.
Manual recipe: create an Australia .pmtiles basemap
What you’re making
You’re building a PMTiles basemap from OpenStreetMap data for Australia.
The final output will be a file like:
australia.pmtiles
That single file can then be imported via the maps admin.
1. What you need first
Hardware / patience
Australia is not tiny, so this is not the fastest “hello world”
example.
A reasonable beginner setup:
8 GB RAM minimum
16 GB RAM preferred
20–50 GB free disk space
decent internet connection
If the machine is small, the build may still work, just slower.
Software prerequisites
Install:
Git
Java 21+
Maven
optionally Node.js if you also want the Protomaps demo app
On Ubuntu/Debian
sudo apt update
sudo apt install -y git maven openjdk-21-jdk
Check versions
java -version
mvn -version
git --version
You want Java 21 or newer.
2. Get the basemaps code
Clone the Protomaps basemaps repository:
git clone https://github.com/protomaps/basemaps.git
cd basemaps/tiles
This tiles/ folder is where the actual PMTiles build happens.
3. Build the JAR once
Compile the project:
mvn clean package -DskipTests
When it finishes, you should have a file in target/ ending in
-with-deps.jar.
Check:
ls target/*-with-deps.jar
If that file exists, the build step succeeded.
4. Decide where your files will go
For a beginner, it helps to make a simple working folder.
Example:
mkdir -p ~/mapbuild/australia/data/sources
mkdir -p ~/mapbuild/australia/data/tmp
Suggested layout:
~/mapbuild/australia/data/sources/ → downloaded OSM input
~/mapbuild/australia/data/tmp/ → temporary working data
~/mapbuild/australia/australia.log → build log
~/mapbuild/australia.pmtiles → final output
5. Run the Australia build
From inside basemaps/tiles, run:
java -Xmx6g -jar target/*-with-deps.jar
--download
--force
--osm_path="$HOME/mapbuild/australia/data/sources/australia-latest.osm.pbf"
--osm_url="
https://download.geofabrik.de/australia-oceania/australia-latest.osm.pbf"
--output="$HOME/mapbuild/australia.pmtiles"
2>&1 | tee "$HOME/mapbuild/australia/australia.log"
What those flags mean
-Xmx6g
give Java up to 6 GB RAM
--download
download required source data automatically
--force
overwrite old outputs if needed
--osm_path=...
where the Australia OSM extract should live locally
--osm_url=...
where to fetch the Australia extract from
--output=...
where to write the finished .pmtiles file
tee australia.log
save the console output to a log file while still showing it live
6. Wait for it to finish
This can take a while. On a modest machine, think in terms of:
tens of minutes for a country like Monaco, hours for a country like
Belgium, nearly a day for France/Germany from what I tried so far.
possibly longer if disk / CPU / RAM are limited
While it runs, watch the output in the terminal.
In another terminal, you can also inspect the log:
tail -f ~/mapbuild/australia/australia.log
7. Confirm success
When the build is done, check that the output file exists:
ls -lh ~/mapbuild/australia.pmtiles
If you see a large .pmtiles file, that usually means success.
You can also confirm the log didn’t end with an error:
tail -50 ~/mapbuild/australia/australia.log
8. Serve the file locally for testing
The easiest beginner method is a tiny local web server.
Go to the output folder:
cd ~/mapbuild
python3 -m http.server 8000
Now your file should be reachable at:
http://localhost:8000/australia.pmtiles (you can copy this into the
manual upload path of N.O.M.A.D maps admin)
If you’re on another machine in the same network, replace localhost with
that machine’s IP.
9.
Upload to N.O.M.A.D project.
10.
Reload map (sometimes I need to restart for it to update)
—
Reply to this email directly, view it on GitHub
<#335 (reply in thread)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AAHWNTCL5FOH42GG3MKFOYL4RIKNVAVCNFSM6AAAAACWSRDDJCVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTMMJYGY4DGMI>
.
You are receiving this because you commented.Message ID:
<Crosstalk-Solutions/project-nomad/repo-discussions/335/comments/16186831@
github.com>
|
Beta Was this translation helpful? Give feedback.
-
|
WOW - done! 16 mins and I now have Australia loaded. If you make yours
public somewhere I can add Australia to it. thanks!
On Wed, Mar 18, 2026 at 4:25 PM Tim Austin-Mills ***@***.***>
wrote:
… Brilliant instructions...
Its busy doing something! Fans screaming :) Old NUC i5 2 core (32gb RAM)
On Wed, Mar 18, 2026 at 2:34 PM travelingnomad1 ***@***.***>
wrote:
> I am currently downloading osm.pbf maps myself from
> https://download.geofabrik.de/ and converting them (process below). I am
> happy to share countries, but have no write access for the map repository
> project-nomad-maps, but if you or others do some, too, we could share the
> load and split up, so not 10 people convert the same country for themselves.
>
> Currently I finished: *Albania, Andorra, Austria, Azores, Belarus,
> Belgium, Bosnia-Herzegovina, Bulgaria, Denmark, Iceland, Greenland,
> Liechtenstein and Luxembourg.* If you need some of these, let me know
> and I will find a place to upload.
>
> Here is an example of how I do it. I Use Australia for example, but if
> you want a quick check if things are working, try a smaller country like
> Monaco or the Azores islands.
>
> Manual recipe: create an Australia .pmtiles basemap
> What you’re making
> You’re building a PMTiles basemap from OpenStreetMap data for Australia.
>
> The final output will be a file like:
>
> australia.pmtiles
> That single file can then be imported via the maps admin.
>
> 1. What you need first
> Hardware / patience
> Australia is not tiny, so this is not the fastest “hello world”
> example.
>
> A reasonable beginner setup:
>
> 8 GB RAM minimum
> 16 GB RAM preferred
> 20–50 GB free disk space
> decent internet connection
> If the machine is small, the build may still work, just slower.
>
> Software prerequisites
> Install:
>
> Git
> Java 21+
> Maven
> optionally Node.js if you also want the Protomaps demo app
> On Ubuntu/Debian
>
> sudo apt update
> sudo apt install -y git maven openjdk-21-jdk
>
> Check versions
> java -version
> mvn -version
> git --version
> You want Java 21 or newer.
>
> 2. Get the basemaps code
> Clone the Protomaps basemaps repository:
>
> git clone https://github.com/protomaps/basemaps.git
> cd basemaps/tiles
> This tiles/ folder is where the actual PMTiles build happens.
>
> 3. Build the JAR once
> Compile the project:
>
> mvn clean package -DskipTests
> When it finishes, you should have a file in target/ ending in
> -with-deps.jar.
>
> Check:
>
> ls target/*-with-deps.jar
> If that file exists, the build step succeeded.
>
> 4. Decide where your files will go
> For a beginner, it helps to make a simple working folder.
>
> Example:
>
> mkdir -p ~/mapbuild/australia/data/sources
> mkdir -p ~/mapbuild/australia/data/tmp
>
> Suggested layout:
>
> ~/mapbuild/australia/data/sources/ → downloaded OSM input
> ~/mapbuild/australia/data/tmp/ → temporary working data
> ~/mapbuild/australia/australia.log → build log
> ~/mapbuild/australia.pmtiles → final output
>
> 5. Run the Australia build
> From inside basemaps/tiles, run:
>
> java -Xmx6g -jar target/*-with-deps.jar
> --download
> --force
> --osm_path="$HOME/mapbuild/australia/data/sources/australia-latest.osm.pbf"
>
> --osm_url="
> https://download.geofabrik.de/australia-oceania/australia-latest.osm.pbf"
>
> --output="$HOME/mapbuild/australia.pmtiles"
> 2>&1 | tee "$HOME/mapbuild/australia/australia.log"
> What those flags mean
> -Xmx6g
> give Java up to 6 GB RAM
>
> --download
> download required source data automatically
>
> --force
> overwrite old outputs if needed
>
> --osm_path=...
> where the Australia OSM extract should live locally
>
> --osm_url=...
> where to fetch the Australia extract from
>
> --output=...
> where to write the finished .pmtiles file
>
> tee australia.log
> save the console output to a log file while still showing it live
>
> 6. Wait for it to finish
> This can take a while. On a modest machine, think in terms of:
>
> tens of minutes for a country like Monaco, hours for a country like
> Belgium, nearly a day for France/Germany from what I tried so far.
> possibly longer if disk / CPU / RAM are limited
> While it runs, watch the output in the terminal.
>
> In another terminal, you can also inspect the log:
>
> tail -f ~/mapbuild/australia/australia.log
>
> 7. Confirm success
> When the build is done, check that the output file exists:
>
> ls -lh ~/mapbuild/australia.pmtiles
> If you see a large .pmtiles file, that usually means success.
>
> You can also confirm the log didn’t end with an error:
>
> tail -50 ~/mapbuild/australia/australia.log
>
> 8. Serve the file locally for testing
> The easiest beginner method is a tiny local web server.
>
> Go to the output folder:
>
> cd ~/mapbuild
> python3 -m http.server 8000
> Now your file should be reachable at:
>
> http://localhost:8000/australia.pmtiles (you can copy this into the
> manual upload path of N.O.M.A.D maps admin)
> If you’re on another machine in the same network, replace localhost with
> that machine’s IP.
>
> 9.
>
> Upload to N.O.M.A.D project.
> 10.
>
> Reload map (sometimes I need to restart for it to update)
>
> —
> Reply to this email directly, view it on GitHub
> <#335 (reply in thread)>,
> or unsubscribe
> <https://github.com/notifications/unsubscribe-auth/AAHWNTCL5FOH42GG3MKFOYL4RIKNVAVCNFSM6AAAAACWSRDDJCVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTMMJYGY4DGMI>
> .
> You are receiving this because you commented.Message ID:
> <Crosstalk-Solutions/project-nomad/repo-discussions/335/comments/16186831
> @github.com>
>
|
Beta Was this translation helpful? Give feedback.
-
|
Glad to hear you were able to get Australia generated! You are always welcome to submit a PR to the dedicated repo we have for maps at https://github.com/Crosstalk-Solutions/project-nomad-maps (uses Git LFS) and then other users will be able to use them once we enhance support for non-US region downloads! (coming soon-ish) |
Beta Was this translation helpful? Give feedback.
-
|
I noticed that while a lot of details have transferred, the streets around
my house are missing. (old area) Is there an online - version of the
original file that I can check to see if it's there or it was omitted while
translating?
…On Thu, Mar 19, 2026 at 8:35 AM Jake Turner ***@***.***> wrote:
Glad to hear you were able to get Australia generated! You are always
welcome to submit a PR to the dedicated repo we have for maps at
https://github.com/Crosstalk-Solutions/project-nomad-maps (uses Git LFS)
and then other users will be able to use them once we enhance support for
non-US region downloads! (coming soon-ish)
—
Reply to this email directly, view it on GitHub
<#335 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AAHWNTGW5FIE4XIYNB22SC34RMJA3AVCNFSM6AAAAACWSRDDJCVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTMMJZHA3DSNA>
.
You are receiving this because you commented.Message ID:
<Crosstalk-Solutions/project-nomad/repo-discussions/335/comments/16198694@
github.com>
|
Beta Was this translation helpful? Give feedback.
-
|
This process worked for Canada, took 3 hours to download and process the maps. If there are other Canuck users the command for Canada is java -Xmx6g -jar target/*-with-deps.jar Once it is done, cp canada.pmtiles /opt/project-nomad/storage/maps/pmtiles And then click "force refresh collections" in the maps manager, and Canada maps work. |
Beta Was this translation helpful? Give feedback.
-
|
Looking at how long its taken others do you think 16 minutes was too quick
for Australia? Is there somewhere I can send the converted map to see if
its missing information - as I mentioned it doesnt have my address but I
cant see a way to compare the original.
…On Wed, Mar 25, 2026 at 6:43 AM George Walker ***@***.***> wrote:
This process worked for Canada, took 3 hours to download and process the
maps. If there are other Canuck users the command for Canada is
java -Xmx6g -jar target/*-with-deps.jar
--download
--force
--osm_path="$HOME/mapbuild/canada/data/sources/canada-latest.osm.pbf"
--osm_url="
https://download.geofabrik.de/north-america/canada-latest.osm.pbf"
--output="$HOME/mapbuild/canada.pmtiles"
2>&1 | tee "$HOME/mapbuild/canada/canada.log" \
Once it is done,
cp canada.pmtiles /opt/project-nomad/storage/maps/pmtiles
And then click "force refresh collections" in the maps manager, and Canada
maps work.
—
Reply to this email directly, view it on GitHub
<#335?email_source=notifications&email_token=AAHWNTEWKOQAM4EHYKLIDBT4SLQOHA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCNRSHE4DIMJRUZZGKYLTN5XKOY3PNVWWK3TUUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y#discussioncomment-16298411>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AAHWNTHLODTOIMDRGRIEQET4SLQOHAVCNFSM6AAAAACWSRDDJCVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTMMRZHA2DCMI>
.
You are receiving this because you commented.Message ID:
<Crosstalk-Solutions/project-nomad/repo-discussions/335/comments/16298411@
github.com>
|
Beta Was this translation helpful? Give feedback.
-
|
German State Maps: https://github.com/whitespring/project-nomad-maps-europe |
Beta Was this translation helpful? Give feedback.
-
|
australian maps: https://github.com/kcoffau/N.O.M.A.D-Offline-Mapping---Australia |
Beta Was this translation helpful? Give feedback.
Uh oh!
There was an error while loading. Please reload this page.
-
Hi!
As far as I can see only USA maps are available by default now.
Do you have plans to include EU and other regions later?
Thank you.
Beta Was this translation helpful? Give feedback.
All reactions