terriajs-server

TerriaJS-Server

This is a basic NodeJS Express server that serves up a (not included) static TerriaJS site (such as National Map) with a few additional useful services:

• /proxy: a proxy service which applies CORS headers for data providers that lack them. Add URLs to config.json to enable them.
• /proj4def: a proj4 coordinate reference system lookup service.
• /convert: an ogr2ogr server-side conversion service.
• /ping: returns 200 OK.
• All other requests are served from the wwwroot directory you provide on the command line, which defaults to ./wwwroot

Install

1. Download and build your National Map (or AREMI, etc) somewhere.
2. git clone https://github.com/terriajs/terriajs-server
3. cd terriajs
4. npm install

Configure

If you are running the server separately from a built TerriaJS map, create a local config.json with a list of domains you're willing to proxy for:

{
    "proxyDomains": [
        "gov.au"
    ]
}

Run

1. node app path/to/myterriamap/wwwroot

app [options] [path-to-wwwroot]

Options:
  --port                         Port to listen on.              [default: 3001]
  --public                       Run a public server that listens on all
                                 interfaces.           [boolean] [default: true]
  --upstream-proxy               A standard proxy server that will be used to
                                 retrieve data.  Specify a URL including port,
                                 e.g. "http://proxy:8000".
  --bypass-upstream-proxy-hosts  A comma separated list of hosts that will
                                 bypass the specified upstream_proxy, e.g.
                                 "lanhost1,lanhost2"
  --help, -h                     Show this help.                       [boolean]