Dezfil

Self-hosted spatial SQL and map publishing, powered by DuckDB and files. Upload geospatial data, query it with SQL, style it on a map, publish a shareable view, from one container.

Status: pre-release, under active development.

Run it

With Docker installed:

docker run -d --name dezfil -p 127.0.0.1:3000:3000 -v dezfil-data:/data ghcr.io/dezfil/dezfil

For development, with live reload, run npm ci and then npm run dev.

Open http://localhost:3000 and create the first admin account. Install covers each way in full, with Docker Compose and the first-run setup.

Documentation

The documentation is published at dezfil.io/docs. The same pages live in docs/, one folder per section, and the index lists every page with its summary and when to read it. Begin with What Dezfil is or Install.

Contributing

CONTRIBUTING.md says how to get a change from your machine into the project, and Development setup which checks a change runs.

License

Apache-2.0. Code adapted from permissively licensed projects (such as MapLibre GL JS, kepler.gl, deck.gl and osmtogeojson) keeps its original license header in the file, with the source noted in NOTICE. The data in the shipped templates stays under its sources' licences, also listed there.