Windshaft-cartodb/INSTALL.md

Installing Windshaft-CartoDB

Requirements

Make sure that you have the requirements needed. These are

• Core

  • Node.js >=0.8
  • npm >=1.2.1 <2.0.0
  • PostgreSQL >8.3.x, PostGIS >1.5.x
  • Redis >2.4.0 (http://www.redis.io)
  • Mapnik 2.0.1, 2.0.2, 2.1.0, 2.2.0, 2.3.0. See Installing Mapnik.
  • Windshaft: check Windshaft dependencies and installation notes
  • libcairo2-dev, libpango1.0-dev, libjpeg8-dev and libgif-dev for server side canvas support

• For cache control (optional)

  • CartoDB 0.9.5+ (for CDB_QueryTables)
  • Varnish (http://www.varnish-cache.org)

On Ubuntu 14.04 the dependencies can be installed with

sudo apt-get update
sudo apt-get install -y make g++ pkg-config git-core \
  libgif-dev libjpeg-dev libcairo2-dev \
  libhiredis-dev redis-server \
  nodejs nodejs-legacy npm \
  postgresql-9.3-postgis-2.1 postgresql-plpython-9.3 postgresql-server-dev-9.3

On Ubuntu 12.04 the cartodb/cairo PPA may be useful.

PostGIS setup

A template_postgis database is expected. One can be set up with

createdb --owner postgres --template template0 template_postgis
psql -d template_postgis -c 'CREATE EXTENSION postgis;'

Build/install

To fetch and build all node-based dependencies, run:

npm install

Note that the npm install step will populate the node_modules/ directory with modules, some of which being compiled on demand. If you happen to have startup errors you may need to force rebuilding those modules. At any time just wipe out the node_modules/ directory and run npm install again.