Installation Steps for OSX

[cybertoast]

Some clarification on installation on OSX, and possible trouble-shooting steps for newbies. Hopefully this will help someone.

# Install node
brew install node  # You'll now have the latest node version (0.6.x)
cd /usr/local/Cellar/node
brew versions node
git checkout -b node-0.4.9 10b3ded # The commit will be in the versions output
brew install node # You'll now have version 0.4.9
brew switch node 0.4.9

# Install npm for the appropriate Node version
curl http://npmjs.org/install.sh | sh

# Install tilestream
git clone tilestream
cd tilestream

npm install

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!).

Build failures:

npm install may cause:

Waf: Leaving directory `/Users/sundar/Projects/tilestream/node_modules/sqlite3/build'
Build failed:
 -> task failed (err #1): 
    {task: cxx statement.cc -> statement_1.o}
 -> task failed (err #1): 
    {task: cxx database.cc -> database_1.o}
 -> task failed (err #1): 
    {task: cxx sqlite3.cc -> sqlite3_1.o}
npm ERR! sqlite3@2.1.1 preinstall: `node-waf clean || (exit 0); node-waf configure build`
npm ERR! `sh "-c" "node-waf clean || (exit 0); node-waf configure build"` failed with 1
npm ERR! 
npm ERR! Failed at the sqlite3@2.1.1 preinstall script.

Manually installing sqlite3 via npm install sqlite3 resolved this issue. Then re-run npm install in the tilestream folder:

npm install sqlite3
npm install

If you STILL get errors when launching index.js, there may be more modules to install manually. This is the list that worked for me:

npm install sqlite3
npm install mbtiles
npm install jsdom
npm install uglify-js
npm install connect
npm install qs
npm install mime

[willwhite]

Hi @cybertoast,
Thanks for the post. It you have a moment a pull request against the README in this repo would be appreciated. That will make sure everyone sees these steps.

Thanks,
Will

[cybertoast]

Done.

[avanderpluijm]

Thanks, this helped me to make it work!