{"title":"Installing Spatialite","version":"1.8","locale":"en","docname":"ref/contrib/gis/install/spatialite","url":"/en/1.8/ref/contrib/gis/install/spatialite/","canonical":"https://djangodocs.dev/en/1.8/ref/contrib/gis/install/spatialite/","summary":"SpatiaLite adds spatial support to SQLite, turning it into a full-featured spatial database. Check first if you can install Spatialite from system packages or…","html":"

Installing SpatialiteLink to this heading#

\n

SpatiaLite adds spatial support to SQLite, turning it into a full-featured\nspatial database.

\n

Check first if you can install Spatialite from system packages or binaries. For\nexample, on Debian-based distributions, try to install the spatialite-bin\npackage. For Mac OS X, follow the\nspecific instructions below. For Windows, you may\nfind binaries on Gaia-SINS home page. In any case, you should always\nbe able to install from source.

\n

When you are done with the installation process, skip to Creating a spatial database for SpatiaLite.

\n
\n

Installing from sourceLink to this heading#

\n

GEOS and PROJ.4 should be installed\nprior to building SpatiaLite.

\n
\n

SQLiteLink to this heading#

\n

Check first if SQLite is compiled with the R*Tree module. Run the sqlite3\ncommand line interface and enter the following query:

\n
Code
sqlite> CREATE VIRTUAL TABLE testrtree USING rtree(id,minX,maxX,minY,maxY);\n
\n

If you obtain an error, you will have to recompile SQLite from source. Otherwise,\njust skip this section.

\n

To install from sources, download the latest amalgamation source archive from\nthe SQLite download page, and extract:

\n
Code
$ wget http://sqlite.org/sqlite-amalgamation-3.6.23.1.tar.gz\n$ tar xzf sqlite-amalgamation-3.6.23.1.tar.gz\n$ cd sqlite-3.6.23.1\n
\n

Next, run the configure script – however the CFLAGS environment variable\nneeds to be customized so that SQLite knows to build the R*Tree module:

\n
Code
$ CFLAGS="-DSQLITE_ENABLE_RTREE=1" ./configure\n$ make\n$ sudo make install\n$ cd ..\n
\n
\n
\n

SpatiaLite library (libspatialite)Link to this heading#

\n

Get the latest SpatiaLite library source bundle from the\ndownload page:

\n
Code
$ wget http://www.gaia-gis.it/gaia-sins/libspatialite-sources/libspatialite-4.1.0.tar.gz\n$ tar xaf libspatialite-4.1.0.tar.gz\n$ cd libspatialite-4.1.0\n$ ./configure\n$ make\n$ sudo make install\n
\n\n
\n
\n

pysqlite2Link to this heading#

\n

If you’ve decided to use a newer version of pysqlite2 instead of the sqlite3 Python stdlib\nmodule, then you need to make sure it can load external extensions (i.e. the\nrequired enable_load_extension method is available so SpatiaLite can be\nloaded).

\n

This might involve building it yourself. For this, download pysqlite2 2.6, and\nuntar:

\n
Code
$ wget https://pypi.python.org/packages/source/p/pysqlite/pysqlite-2.6.3.tar.gz\n$ tar xzf pysqlite-2.6.3.tar.gz\n$ cd pysqlite-2.6.3\n
\n

Next, use a text editor to edit the setup.cfg file to look like the\nfollowing:

\n
Ini
[build_ext]\n#define=\ninclude_dirs=/usr/local/include\nlibrary_dirs=/usr/local/lib\nlibraries=sqlite3\n#define=SQLITE_OMIT_LOAD_EXTENSION\n
\n

or if you are on Mac OS X:

\n
Ini
[build_ext]\n#define=\ninclude_dirs=/Library/Frameworks/SQLite3.framework/unix/include\nlibrary_dirs=/Library/Frameworks/SQLite3.framework/unix/lib\nlibraries=sqlite3\n#define=SQLITE_OMIT_LOAD_EXTENSION\n
\n\n

After modifying setup.cfg appropriately, then run the setup.py script\nto build and install:

\n
Code
$ python setup.py install\n
\n
\n
\n
\n

Mac OS X-specific instructionsLink to this heading#

\n

To install the SpatiaLite library and tools, Mac OS X users can choose between\nKyngChaos and Homebrew.

\n
\n

KyngChaosLink to this heading#

\n

First, follow the instructions in the KyngChaos section.

\n

When Creating a spatial database for SpatiaLite, the spatialite program is required.\nHowever, instead of attempting to compile the SpatiaLite tools from source,\ndownload the SpatiaLite Binaries for OS X, and install spatialite in a\nlocation available in your PATH. For example:

\n
Code
$ curl -O http://www.gaia-gis.it/spatialite/spatialite-tools-osx-x86-2.3.1.tar.gz\n$ tar xzf spatialite-tools-osx-x86-2.3.1.tar.gz\n$ cd spatialite-tools-osx-x86-2.3.1/bin\n$ sudo cp spatialite /Library/Frameworks/SQLite3.framework/Programs\n
\n

Finally, for GeoDjango to be able to find the KyngChaos SpatiaLite library,\nadd the following to your settings.py:

\n
Code
SPATIALITE_LIBRARY_PATH='/Library/Frameworks/SQLite3.framework/SQLite3'\n
\n
\n
\n

HomebrewLink to this heading#

\n

Homebrew handles all the SpatiaLite related packages on your behalf,\nincluding SQLite3, SpatiaLite, PROJ, and GEOS. Install them like this:

\n
Code
$ brew update\n$ brew install spatialite-tools\n$ brew install gdal\n
\n

Finally, for GeoDjango to be able to find the SpatiaLite library, add the\nfollowing to your settings.py:

\n
Code
SPATIALITE_LIBRARY_PATH='/usr/local/lib/mod_spatialite.dylib'\n
\n
\n
\n
\n

Creating a spatial database for SpatiaLiteLink to this heading#

\n

When running manage.py migrate with a SQLite or SpatiaLite database, the\ndatabase file will be automatically created if it doesn’t exist. Django will\nalso ensure that the spatial metadata are initialized in the database.

\n\n
","rootId":"installing-spatialite","toc":[{"title":"Installing from source","anchor":"installing-from-source","children":[{"title":"SQLite","anchor":"sqlite","children":[]},{"title":"SpatiaLite library (libspatialite)","anchor":"spatialite-library-libspatialite","children":[]},{"title":"pysqlite2","anchor":"pysqlite2","children":[]}]},{"title":"Mac OS X-specific instructions","anchor":"mac-os-x-specific-instructions","children":[{"title":"KyngChaos","anchor":"kyngchaos","children":[]},{"title":"Homebrew","anchor":"homebrew","children":[]}]},{"title":"Creating a spatial database for SpatiaLite","anchor":"creating-a-spatial-database-for-spatialite","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"API Reference","url":"/en/1.8/ref/"},{"docname":"ref/contrib/index","title":"contrib packages","url":"/en/1.8/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/en/1.8/ref/contrib/gis/"},{"docname":"ref/contrib/gis/install/index","title":"GeoDjango Installation","url":"/en/1.8/ref/contrib/gis/install/"}],"prev":{"docname":"ref/contrib/gis/install/postgis","title":"Installing PostGIS","url":"/en/1.8/ref/contrib/gis/install/postgis/"},"next":{"docname":"ref/contrib/gis/model-api","title":"GeoDjango Model API","url":"/en/1.8/ref/contrib/gis/model-api/"},"formats":{"html":"/en/1.8/ref/contrib/gis/install/spatialite/","markdown":"/en/1.8/ref/contrib/gis/install/spatialite.md","json":"/en/1.8/ref/contrib/gis/install/spatialite.json"},"source":"https://github.com/django/django/blob/stable/1.8.x/docs/ref/contrib/gis/install/spatialite.txt","official":"https://docs.djangoproject.com/en/1.8/ref/contrib/gis/install/spatialite/","inVersions":["dev","6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9","1.8"],"inLocales":["en"]}