Installation Guide

Tileoven install on Ubuntu 18.04

This install worked on a fresh install of Ubuntu 18.04 (Aug 2018), and was tested using the Road Trip example.

# Install node package manager
sudo apt-get install npm
npm -v
  3.5.2
node -v
  v8.10.0

# In your home directory, download the tileover source code ..
cd ~
git clone https://github.com/florianf/tileoven.git

# Change to the directory created by the git clone ..
cd tileoven

# Install the tileoven package
npm install

# Install most fonts used in the Road Trip example ..
sudo apt-get install ttf-mscorefonts-installer 

Run the package with nodejs ..   
./index.js 

Now, open up a browser on the same computer and open the URL .. http://localhost:20009

Open the Road Trip project, and wait for map data to be downloaded. You will eventually see a zoomable road map of the USA.

Start index.js automatically on logon

Run the 'Startup Applications' app (search for 'startup'). Add a new entry with the full path to index.js as the command, for example ..

Monitoring MBTiles file creation

The code that creates the MBTiles files is very solid. The most likely cause of failure is running out of memory, so run 'System Monitor' (search for 'monitor'). If the process regularly uses swap space, then add more memory to your computer if possible.

You will notice above that Tileoven is very good at using the full power of your hardware - utilising all available CPU cores.