First of all, you need Git.
If you use a Debian-like distribution with
apt-get, the package is named
If you prefer Homebrew (OSX), the package is named
uData requires Python 2.7 (installed by default on OSX and many Linux distributions), its development tools and some libraries to be installed (with their headers). Most of them might already be installed as they are common development dependencies. The full dependencies list is:
- Pillow (Image processing)
- lxml dependencies
- Misc dependencies
- liblzma (required to load GeoZones)
- libyaml (not mandatory but speed up the yaml processing)
By the time this project was started, Python 3 did not have great third dependencies support and some requirements weren’t suported yet so it was started with Python 2.7.
On any Debian-like system you can install the development tools and libraries with:
$ apt-get install build-essential pkg-config python python-dev python-pip \ libjpeg-dev zlib1g-dev libtiff5-dev libfreetype6-dev \ liblcms2-dev libopenjpeg-dev libwebp-dev libpng12-dev \ libxml2-dev libxslt1-dev liblzma-dev libyaml-dev
On Mac OSX with Homebrew, you can install the development tools and libraries with:
$ brew install automake autoconf libtool pkg-config python \ libjpeg zlib libtiff freetype littlecms openjpeg webp libpng \ libxml2 libxslt xz libyaml
Retrieving the sources¶
The sources of the project are on Github:
$ git clone https://github.com/opendatateam/udata.git
MongoDB, ElasticSearch and Redis¶
Installing these dependencies can be cumbersome given you operating system. That’s why we made a Docker container to ease that step. You can either use it or install these dependencies by hand with the appropriated versions.
Then start the services:
$ cd udata $ docker-compose up
On the very first run it will download and install Docker images which takes a while depending of your connection.
Test your docker-compose is running successfully entering
It should output a JSON search response.
If you have no output at all for too long,
check the IPv6 possible issue.
It will depend on your configuration, join us on Gitter if you have any issue.
Match the Analysis ICU plugin version to your ElasticSearch version (2.4) given those indicated in the official repository
For example if you are using Homebrew (OSX):
$ brew install elasticsearch $ /usr/local/Cellar/elasticsearch/2.4.1/libexec/bin/plugin install analysis-icu
Once all dependencies are installed by hand, you can launch these services manually or use Honcho with the proposed Procfile at the root of the repository (you’ll have to uncomment related lines).
But first, let’s install local dependencies!