t-rex

Create and serve your own vector tiles

Setup

Installation

Ubuntu LTS

Add UbuntuGIS PPA Stable or Unstable.

Install GDAL 2.x library:

sudo apt-get install libgdal20

Download and install DEB package from github.com:

curl -O -L https://github.com/t-rex-tileserver/t-rex/releases/download/v0.8.1/t-rex-v0.8.1-x86_64-unknown-linux-gnu.deb && sudo dpkg -i t-rex-v0.8.1-x86_64-unknown-linux-gnu.deb

Windows

Download MSI installer from github.com:

t-rex-v0.8.1.msi

Double click to install (needs Administrator permissions).

Run in Command Prompt window:

"%programfiles%\t-rex\t_rex"

Docker

Install Docker on your platform.

Download and run the t-rex Docker image:

docker pull sourcepole/t-rex
docker run sourcepole/t-rex --version
docker run -p 6767:6767 sourcepole/t-rex serve --bind=0.0.0.0 --openbrowser=false

There are two volumes for data input and data output.

Argument example using input and output volumes:

docker run -v $PWD:/var/data/in:ro -v /tmp:/var/data/out

Upgrading

See the Changelog for breaking changes in new versions.

0.7.x -> 0.8.0

Conversion to new datasource syntax:

sed -e 's/\[datasource\]/[[datasource]]/g' \
    -e '/type = "postgis"/d' \
    -e 's/url =/dbconn =/g' \
    infile.toml