@basemaps/server

WMTS/XYZ Tile server command line interface.

This wraps the @basemaps/lambda-tiler into a standalone http server using fastify.

Usage

Basemaps server expects a folder tree full of configuration, with multiple tilesets and styles configuration files.

``bash
basemaps-server --config path/to/config/
`

$3

The server is also published as a docker container

`bash
docker run -it \
--volume $PWD/config:/config \
--volume $PWD/tiffs:$PWD/tiffs \
-p 5000:5000 \
ghcr.io/linz/basemaps-server:v6 --config /config
`

Where ${PWD}/config contains all the configuration and ${PWD}/tiffs is all the relevant tiff files

$3

Basemaps server can also be configured with a single JSON configuration bundle file using @basemaps/cli

By bundling the configuration the startup time is greatly reduced as each individual tiff file does not have to be scanned for dimensions, it does mean that new tiffs will not be picked up until a new bundle is created.

`bash
bmc bundle --config config/ --output config.bundle.json
basemaps-server --config config.bundle.json
`

$3

Usage with basemaps config, you will need access to basemaps' imagery cache

please contact basemaps@linz.govt.nz if you need access.

`bash
git clone github.com/linz/basemaps-config

bmc bundle --config basemaps-config/config --output config.bundle.json
basemaps-server --config config.bundle.json
`

$3

If you have a folder of tiffs the @basemaps/server can index the folder and create tiles from it

For example given a structure where there are two folders full of tiffs

`
/images/00_gebco_2021_305-75m/*.tiff
/images/10_geographx_nz_texture_shade_2012_8-0m/*.tiff
`

running basemaps-server /images/00_gebco_2021_305-75m/ /images/10_geographx_nz_texture_shade_2012_8-0m/ will create two tile sets one for each folder gebco_2021... and geographx_nz_t... and then also create a combined layer in the order the tiffs are found.

Developing

When running the @basemaps/server in development mode, ensure @basemaps/landing page has been built and bundled

`bash
npm install
npm run build

npx lerna run bundle --stream # Bundle everything
`

This will package all the static assets into landing/dist and will be served from http://localhost:5000`