You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Sandro Santilli 2646b5275b
Ignore all .pyc files
13 years ago
acceptance add first zombie.js acceptance test 13 years ago
app Refactors upload controller 13 years ago
config rewrite final configuration steps in copy paste friendly format + update app_config sample with new required constants 13 years ago
db tar, gz, tgz all working 13 years ago
doc add infowindow getter and setters 13 years ago
lib Compiled python shouldn't be in repo 13 years ago
misc Typo fix: EmtpyTable > EmptyTable 13 years ago
public Fix 'this.interaction is undefined' error 13 years ago
script removed monkey patching and moved sequel-rails patches to a proper repo. also fixed deprication warnings and other weirdness 13 years ago
spec Refactors upload controller 13 years ago
tmp Add tmp folder to the repo and fix wrong javascript filenames in asset_packages 14 years ago
vendor/plugins Externalized cartodb-importer 13 years ago
.gitignore Ignore all .pyc files 13 years ago
.rvmrc .rvmrc 14 years ago
Gemfile update cartodb-sequel gem to fix Rails::Sequel.connection error 13 years ago
LICENSE dashboard bugs fixed, year changed, edit cell in query mode edited,... 13 years ago
README.md rake doesn't like spaces in arguments. remove them from readme instructions 13 years ago
Rakefile removed monkey patching and moved sequel-rails patches to a proper repo. also fixed deprication warnings and other weirdness 13 years ago
Termfile closes #48 13 years ago
config.ru Moving from ProtoCartodb to CartoDB 14 years ago
jenkings.sh jenkings.sh to run ci tests 13 years ago
python_requirements.txt Fix python_requirements.txt syntax (#600) 13 years ago

README.md

What is CartoDB?

CartoDB is an open source tool that allows for the storage and visualization of geospatial data on the web.

It was built to make it easier for people to tell their stories by providing them with flexible and intuitive ways to create maps and design geospatial applications. CartoDB can be installed on your own server and we also offer a hosted service at cartodb.com.

If you would like to see some live demos, check out our videos on Vimeo. We hope you like it!

What can I do with CartoDB?

With CartoDB, you can upload your geospatial data (Shapefiles, GeoJSON, etc) using a web form and then make it public or private.

After it is uploaded, you can visualize it in a table or on a map, search it using SQL, and apply map styles using CartoCSS. You can even access it using the CartoDB Maps API and SQL API, or export it to a file.

In other words, with CartoDB you can make awesome maps and build powerful geospatial applications! Definitely check out the CartoDB Gallery for interactive examples and code.

What are the components of CartoDB?

  • A User Interface for uploading, creating, editing, visualizing, and exporting geospatial data.
  • A geospatial database built on PostgreSQL and PostGIS 2.0
  • An SQL API for running SQL queries over HTTP with results formatted using GeoJSON and KML
  • A Map tiler that supports SQL and tile styling using CartoCSS
  • Authentication using OAuth if required

What does CartoDB depend on?

  • CartoDB-SQL-API
  • Mapnik 2.0
  • NodeJS 0.4.10+
  • PostGIS 2.0
  • Postgres 9.1.x
  • Redis 2.2+
  • Varnish 3.0+
  • Ruby 1.9.2+
  • Windshaft-cartodb

How do I install CartoDB?

The installation process is fairly painless, and we have successful installations running on Amazon EC2, Linode, and development machines with OS X and Ubuntu.

Before getting started, go ahead and download CartoDB by cloning this repository:

$ git clone https://github.com/Vizzuality/cartodb.git

Or you can just download the CartoDB zip file.

Install Ruby

We implemented CartoDB in the Ruby programming language, so you'll need to install Ruby 1.9.2+.

Install Node.js

Components of CartoDB, like Windshaft, depend on Node.js (version greater than or equal to 0.4.1 but less than version 0.5.0). Basically it's a highly-scalable web server that leverages Google's V8 JavaScript engine.

You can install Node.js and NPM (the Node.js package manager) by following these instructions on Node's GitHub wiki site.

Alternatively, you can install Node.js using brew install node, but NPM has to be installed using the wiki instructions above.

You may run into a few annoying NPM version issuess. If so, don't worry! Just run:

$ curl http://npmjs.org/install.sh | sh

And you will be good to GO.

Install PostgreSQL and PostGIS

PostgreSQL is the relational database that powers CartoDB. PostGIS is the geospatial extension that allows PostgreSQL to support geospatial queries. This is the heart of CartoDB!

First you'll need to install a few dependencies.

  • GDAL is requires for raster support.
  • GEOS is required for geometry function support.
  • JSON-C is required for GeoJSON support.
  • PROJ4 is required for reprojection support.
  • plpython is required for Python support (e.g., sudo apt-get install postgresql-plpython-9.1)

Next install PostgreSQL 9.1.x and PostGIS 2.0.x.

Finally, CartoDB depends on a geospatial database template named template_postgis. In the example script below, make sure that the path to each SQL file is correct. As of PostGIS r8242 for example, spatial_ref_sys.sql is now located in the root installation directory, instead of in the ./postgis directory:

#!/usr/bin/env bash
POSTGIS_SQL_PATH='pg_config --sharedir'/contrib/postgis-2.0
createdb -E UTF8 template_postgis 
createlang -d template_postgis plpgsql 
psql -d postgres -c \
 "UPDATE pg_database SET datistemplate='true' WHERE datname='template_postgis'"
psql -d template_postgis -f $POSTGIS_SQL_PATH/postgis.sql 
psql -d template_postgis -f $POSTGIS_SQL_PATH/spatial_ref_sys.sql
psql -d template_postgis -f $POSTGIS_SQL_PATH/legacy.sql
psql -d template_postgis -f $POSTGIS_SQL_PATH/legacy_compatibility_layer.sql
psql -d template_postgis -c "GRANT ALL ON geometry_columns TO PUBLIC;" 
psql -d template_postgis -c "GRANT ALL ON spatial_ref_sys TO PUBLIC;"

Install Redis

Components of CartoDB, like Windshaft, depend on Redis. Basically it's a really fast key-value datastore used for caching.

To install Redis 2.2+, You can download it here or you can use brew install redis.

Install Python dependencies

To install the Python modules that CartoDB depends on, you can use easy_install, which is easy!

$ easy_install pip 
$ pip install -r python_requirements.txt

If this fails, try doing export ARCHFLAGS='-arch i386 -arch x86_64' beforehand.

Install Varnish

Varish is a web application accelerator. Components like Windshaft use it to speed up serving tiles via the Maps API. Installing it is speedy too!

$ pip install -e
$ git+https://github.com/RealGeeks/python-varnish.git@0971d6024fbb2614350853a5e0f8736ba3fb1f0d#egg=python-varnish

Install Mapnik

Mapnik is an API for creating beautiful maps. CartoDB uses Mapnik 2.0.x for creating and syling map tiles.

To install it using Ubuntu:

$ sudo apt-get install build-essential curl wget python-software-properties
$ sudo add-apt-repository ppa:mapnik/nightly-trunk
$ sudo apt-get update
$ sudo apt-get install libmapnik libmapnik-dev mapnik-utils

To install it using OS X, here is a nice Homebrew recipe.

Install CartoDB SQL API

The CartoDB SQL API component powers the SQL queries over HTTP. To install it:

$ git clone git@github.com:Vizzuality/CartoDB-SQL-API.git
$ cd CartoDB-SQL-API
$ npm install

To run CartoDB SQL API in development mode, simply type:

$ node app.js development

Install Windshaft-cartodb

The Windshaft-cartodb component powers the CartoDB Maps API. To install it:

$ git clone git@github.com:Vizzuality/Windshaft-cartodb.git
$ cd Windshaft-cartodb
$ npm install

To run Windshaft-cartodb in development mode, simply type:

$ node app.js development

Install local instance of cold beer

Congratulations! Everything you need should now be installed. Celebrate by drinking a cold beer before continuing. :)

Running CartoDB

Time to run your development version of CartoDB.

# [mysubdomain] = replace with the subdomain/username of your choice 
#                 (in cartodb, username == subdomain)

# Enter the `cartodb` directory.
cd cartodb

# Create a new gemset
rvm use 1.9.2@cartodb --create

# Install local dependencies 
bundle install --binstubs

# Configure the application constants
mv config/app_config.yml.sample config/app_config.yml
nano config/app_config.yml

# Configure your postgis database connection details
mv config/database.yml.sample config/database.yml
nano config/database.yml

# Add entries to /etc/hosts needed in development
echo "127.0.0.1 admin.localhost.lan" | sudo tee -a /etc/hosts
echo "127.0.0.1 admin.testhost.lan" | sudo tee -a /etc/hosts
echo "127.0.0.1 [mysubdomain].localhost.lan" | sudo tee -a /etc/hosts

# Create your user at [mysubdomain].cartodb.com
bundle exec rake cartodb:db:setup SUBDOMAIN=[mysubdomain] \
PASSWORD=[mypass] ADMIN_PASSWORD=[mypass] EMAIL=[me@mail.com] 

# Update your quota to 10GB
bundle exec rake cartodb:db:set_user_quota['[mysubdomain]',10240]      

# Allow unlimited tables to be created
bundle exec rake cartodb:db:set_unlimited_table_quota['[mysubdomain]'] 

# Allow user to create private tables in addition to public
bundle exec rake \
 cartodb:db:set_user_private_tables_enabled['[mysubdomain]','true'] 

# Set the name of the CartoDB
bundle exec rake \
 cartodb:db:set_user_account_type['[mysubdomain]','[DEDICATED]'] 

Finally, start the CartoDB development server on port 3000:

$ rails server -p 3000

You should now be able to access http://[mysubdomain].localhost.lan:3000 in your browser and login with the password specified above.

Note on tiling, SQL API and Redis

Please ensure CartoDB-SQL-API, Windshaft-cartodb, and Redis are all running for full experience.

Manual configuration is needed for the public/javascripts/environments/development.js file which configures Windshaft-cartodb tile server URLs.

Contributors

  • Fernando Blat (@ferblape)
  • Javier Álvarez Medina (@xavijam)
  • Simon Tokumine (@tokumine)
  • Alvaro Bautista (@batu)
  • Fernando Espinosa (@ferdev)
  • Sergio Alvarez Leiva (@saleiva)
  • Javier de la Torre (@jatorre)
  • Andrew W Hill (@andrewxhill)
  • Javier Santana (@javisantana)
  • Javier Arce (@javierarce)
  • Aaron Steele (@eightysteele)
  • Luis Bosque (@luisico)
  • Sandro Santilli (@strk)