Windshaft-cartodb/INSTALL.md

Installing Windshaft-CartoDB

Requirements

Make sure that you have the requirements needed. These are:

• Node 10.x
• npm 6.x
• PostgreSQL >= 10.0
• PostGIS >= 2.4
• CARTO Postgres Extension >= 0.24.1
• Redis >= 4
• libcairo2-dev, libpango1.0-dev, libjpeg8-dev and libgif-dev for server side canvas support
• C++11 (to build internal dependencies if needed)

Optional

• Varnish (http://www.varnish-cache.org)

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 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 again.