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.
- MBTiles-based tile server
- Minimal gallery view and map viewer for tiles
- Support for MBTiles interaction using Wax
- TileStream client
- Tested: Chrome 6+, Firefox 3+, IE8+
- May work: Opera 11
- TileStream server
- Tested: Mac OS X 10.6, Ubuntu 10.04, Ubuntu 11.04
- Tested: node 0.4.9
- Tested: npm v1.0.3
- At least 613MB memory
- May work: Older versions, other POSIX-compliant systems
Install Xcode for Mac OS X.
Install node.
Install npm:
curl http://npmjs.org/install.sh | sh
Install TileStream:
If you have a checked out copy of the source, build it:
npm install
You may also install from anywhere:
npm install -g tilestream
This will install TileStream globally. If you want a local installation in
your current working directory, run the command without the -g option.
Start TileStream:
tilestream (if you installed globally)
./index.js (if running from the source copy)
TileStream should now be accessible from a browser at http://localhost:8888.
Install build requirements:
sudo apt-get install curl build-essential libssl-dev libsqlite3-0 libsqlite3-dev git-core
Install node:
git clone --depth 1 git://github.com/joyent/node.git
cd node
git checkout v0.4.9
export JOBS=2 # optional, sets number of parallel commands.
mkdir ~/local
./configure --prefix=$HOME/local/node
make
make install
echo 'export PATH=$HOME/local/node/bin:$PATH' >> ~/.profile
source ~/.profile
Install npm:
curl http://npmjs.org/install.sh | sh
Install TileStream:
npm install -g tilestream
This will install TileStream globally. If you want a local installation in
your current working directory, run the command without the -g option.
Start TileStream:
tilestream
TileStream should now be accessible from a browser at http://localhost:8888.
If you intend to run TileStream as a server on a hostname or an IP rather than
as localhost, specify that hostname when you run TileStream:
tilestream --host 127.0.0.1
tilestream --host yourhost.com
In these examples, you would only be able to access tilestream from 127.0.0.1
or yourhost.com, respectively, due to security restrictions.
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.
world-light.mbtiles control_room.mbtiles PartyLikeIts1999.mbtiles -
May not contain periods, spaces, non ASCII characters or other punctuation.
World Light.mbtiles BlueWorld-1.0.mbtiles
To see the options available for use with TileStream, run
tilestream start --help
TileStream tests use Expresso.
npm install -g expresso
cd tilestream
npm test
See the configuration_examples directory for configuration examples with
nginx and upstart.