Automated mapping of AREDN Networks.
2016-2018 - Eric Satterlee / KG6WXC
Addtional Credit to: Mark/N2MH and Glen/K6GSE for their work on this project.
Licensed under GPL v3
Donations / Beer accepted! :) (paypal possibly coming soon, email: in the meantime.)

Demo Map


In theory, this should run on a Windows system as well.
It does not require anything specific to Linux (Perhaps with the exception of the cron task.)
There is no reason that it could not be adapted to run from a Windows scheduled task though.
PHP is PHP after all.

Map Tile Server info

Without a map tile server or static tiles, Mesh users without internet access on their systems may not see any map tiles.
On the mesh, you cannot expect the client to have internet access in order to retrieve the tiles, you must provide them yourself, one way or another.
The main map webpage will try to check for internet access and load the appropriate maps.
Default internet map tile servers have been provided in the ini file, but the ini file will need tweaking if you want to use “local” tile servers or directories.

It is way beyond the scope of this README file to help in setting up a map tile server.
You are unfortunatly on your own there.
It is a time consuming and computationaly expensive process, but can be done on “normal” hardware.
It also takes 100’s of GB of HD space if you want to map the entire world, and that does not include the tiles themselves, that is only for the data required to create the map tiles.
A good place to start for more info is:
If you attempt it, be patient, you will get it wrong more than a few times but in the end you might be surprised. :)

Another option is that some programs, Xastir in particular, will save the map tiles they use.
You *can* use those tiles as well, but they must be made to be accessible by your webserver.

You might be able to convice KG6WXC to create local map tiles for you, if the area you want is in the USA… It literally takes days to make them though!

Initial setup for a freshly installed Raspbian 9 (Stretch) system

(Should work for other Linuxes as well, change where needed)

The way the user editable files are distrubuted will change in the near future, for now use this method.
I will always strive to not overwrite your site changes when I make updates to certain files.

If the --test-mode-no-sql is successful, you can go ahead and run the script with --test-mode-with-sql or just without any options.
Run the script without options and there is no on screen output (this is for cron).

Updating the scripts

Simply run a “git pull” from the meshmap directory and the scripts will be updated from the git repo.
The, meshmap-settings.ini,, and files will not be affected by updating.
The settings in the ini files may still change in future versions.
For now tho, if the ini files change, and you still have the old ones in use, things will probably break! Be Warned!
Hopefully in the future this process can be more automated.

If you make changes beyond the user editable files I encourage you to perhaps push the changes upstream, please contact if you wish to do so.

I am making changes all the time, it would be a good idea to run “git pull” from time to time to find any updates.

Notes on usage of the map pages

http://(hostname)/meshmap/node_report.php will show you all the info in the DB without trying to map anything.
This can be useful to see if all the data is there or to find nodes that have no location set. (or other issues)

There is an “admin” page, which is still in the works, what is there now does work tho.
Try to load up: http://(hostname)/meshmap/admin/admin.php in your web browser.
I’ve tried to provide instructions on the admin pages themselves.
From the admin pages you can “fix” a nodes location, which can be helpful for those users that forget the “-” in front of their longitude. :)
The admin pages also allow for the addition of “Non Mesh” Markers, fire stations, police stations, EOC’s , etc…

ToDo List

(In no particular order)
- [x] Add new MeshMap Logo.
- [ ] Change the user editable files to be distributed with “-default” added to the extension, no more tar.gz file.
- [ ] Use a cookie instead of _POST for the internet check (No more stupid dialog box on refresh).
- [ ] Make “Parallel Threads” work again in get-map-info script, with limits on how many can be run at once (this will greatly speed up network polling).
- [ ] Changes so can have the new version too!
- [ ] Change css file for the “?” slide-out menu.
- [ ] Fix a typo in the attribution bar so the pop-up for the links is only for the links number.
- [ ] Implement N2MH’s “Link aging” idea(s).
- [ ] The “Planning” Tab.
- [ ] Make it so other networks can export their data for use on a “Mega Map” type page. :)


Contribution is encouraged!!
I can’t think of everything!
If you find an improvement, typo, or whatever, please, send an email to and we can get you setup with write access if you’d like!

This README file last updated: april 2018