TileStream is a high-performance map tile server powered by MBTiles files.
It's like TileCache, TileStache, and other map servers in that it serves normal
image files that can be used in OpenLayers, Google Maps, Modest Maps, and other
Javascript APIs without much trouble - and with lots of enhancements when you
use Wax.
It's not like those tile servers in that it doesn't yet generate maps, it only
serves maps that are generated with TileMill.
This means that it's reliably fast but not designed to serve live data.
MapBox Hosting uses the same internals as
TileStream but adds many features and is a hosted service rather than an
installable application.
Install node. If you are using HomeBrew, use these steps:
brew install node # Installs the latest node: should be v0.8.xbrew versions node # Find all the different versions of node availablebrew switch node 0.8.15 # set current node version
In these examples, you would only be able to access tilestream from 127.0.0.1
or yourhost.com, respectively, due to security restrictions.
Usage
MBTiles files should be placed in the ~/Documents/MapBox/tiles directory,
which is created at first run. Each tileset can be previewed at
http://localhost:8888/map/[filename] where [filename] is the name of the
tileset file without the .mbtiles extension.
Tileset filenames:
May contain letters (lower or upper case), numbers, underscores or dashes.
See the configuration_examples directory for configuration examples with
nginx and upstart.
Troubleshooting
If you run into problems during install, such as unfound dependent versions, first try deleting the node_modules/ folder and re-run node install. It seems that some errors leave the installation in an unclean state (for example if you accidentally switched node versions during the install in the hopes of making things work!).