README.md

Velomapa vector tiles

Scripts and instructions for generating (planetiler) vector tiles and running tile server (tileserver-gl). Velomap vector style is based on OSM-liberty.

Styles can be edited online https://maputnik.github.io/

Genereting Tiles

Scripts for building Europe vector tiles using https://github.com/onthegomap/planetiler. Tiles without any details will be also generated for whole planet (extra ~25GB).

Running

mkdir ./src
cd src
git clone [email protected]:velomapa/vector-tiles.git
cd ~

bash ./src/vector-tiles/generate_tiles.sh

Planetiler Options

• --nodemap-storage=mmap - requires 0.5x of the xxx.osm.pbf input size
• --nodemap-storage=ram - requires 1.5x of the xxx.osm.pbf input size
• --bounds=planet - it will generate tiles without details for whole planet - adds extra ~25GB to the output file

Results

• server CPX51 16 VCPU; 32 GB RAM; 360 GB SSD
• mbtiles 53GB
• time 1h39m38s

Runing tileserver

NOTE: this will expose 8008 port outside of the firewall

docker run --rm -it -v "$(pwd)/data":/data -p 8080:8080 maptiler/tileserver-gl -p 8080

Moving file between servers

• nohup - it will make sure that command will still run after loging out, NOTE: & is needed
• https://linux.die.net/man/1/rsync

# Pull: rsync [OPTION...] [USER@]HOST:SRC... [DEST]
# Push: rsync [OPTION...] SRC... [USER@]HOST:DEST

nohup rsync --progress [email protected]:/root/data/output.mbtiles ./data &

tail -f nohup.out

Adding Docker to sudo

sudo groupadd docker
sudo gpasswd -a $USER docker
newgrp docker

Running tile server on smaller VPS

Basic Nginx setup and SSL

sudo apt install nginx

# firewall config
sudo ufw allow 'Nginx Full'

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d tiles.velomapa.pl

# auto renewal
sudo systemctl status certbot.timer

# testing renewal process
sudo certbot renew --dry-run

Tileserver and reverse proxy

• -d detached mode

docker run -d --restart unless-stopped -v "$(pwd)/data":/data -p 127.0.0.1:8080:8080 maptiler/tileserver-gl -p 8080

Nginx config for setting up reverse proxy.

 sudo vim /etc/nginx/sites-enabled/default

location ~*  \.(jpg|jpeg|png|webp)$ {
  set $unknown_domain 1;

  if ($http_referer ~* "velomapa.pl") {
    set $unknown_domain 0;
  }

  if ($http_referer ~* "myveloway.com") {
    set $unknown_domain 0;
  }

  if ($http_referer ~* "localhost") {
    set $unknown_domain 0;
  }

  if ($unknown_domain) {
    add_header Cache-Control 'no-store, no-cache';
    return 404;
  }

  proxy_set_header X-Real-IP         $remote_addr;
  proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Forwarded-Host  $host;
  proxy_set_header X-Forwarded-Port  $server_port;
  proxy_set_header Host              $host;
  # 604800=7 days
  add_header Cache-Control "public, max-age=604800";

  proxy_pass http://127.0.0.1:8080;
}

location / {
  proxy_set_header X-Real-IP         $remote_addr;
  proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Forwarded-Host  $host;
  proxy_set_header X-Forwarded-Port  $server_port;
  proxy_set_header Host              $host;

  proxy_pass http://127.0.0.1:8080;
}

restart nginx

sudo systemctl restart nginx

Nginx content caching

mkdir -p /data/nginx/cache

sudo vim /etc/nginx/nginx.conf

http {
    # ...

    proxy_cache_path /data/nginx/cache keys_zone=tilecache:10m;
    proxy_cache_valid 200 302 60m;
}

 sudo vim /etc/nginx/sites-enabled/default

location ~*  \.(jpg|jpeg|png|webp)$ {
  proxy_cache tilecache;

  # ...
}

restart nginx

sudo systemctl restart nginx

Deplyoment

First push all changes to remote repo.

ssh xxx@xxxx
bash ./src/vector-tiles/pull_and_restart_server.sh

Updating mbtiles

Mbtiles are stored in mounted volume. To start using newly generated mbtiles we can:

• attach new volume

  • done manually in the Hetzner web panel

• fetch new mbtiles to the new volume

  • Torrent file: https://www.techidiots.net/downloads/open-base-map-torrents/mbtiles/mbtiles-vector-openmaptiles-openstreetmap-vector-tiles-generated-by-planetiler
  • transmission-cli for downloading torrents in the console

• update symlink

  • -f force option to override existing link

  ln -sf /mnt/XXXX/data mounted-data

• restart tileserver

docker stop $(docker ps -a -q --filter ancestor=maptiler/tileserver-gl)
bash ./run_tileserver.sh