Overview

This section explains how to deploy and maintain production (and production-ish) versions of TerriaJS applications like TerriaMap. Before tackling this section, read Getting Started and Cloning and Building to learn how to build and run TerriaMap locally.

The simplest way to deploy a production ready TerriaMap is to use a cloud provider container service or Kubernetes.

Deploying TerriaMap itself:

• Deploying with Kubernetes: Deploy TerriaMap using Docker and Kubernetes.
• Deploying TerriaMap: General instructions for deploying TerriaMap in almost any environment.

Deploying other services for use with TerriaJS:

• Setting Up a Region Mapping Server: Set up a server for use with TerriaJS's region mapping feature.
• Setting Up Geoserver: Configure GeoServer for effective use with TerriaJS.

Using a TerriaMap in other applications:

• Controlling with URL Parameters: Control a TerriaJS application by passing it URL parameters. This is powerful because it enables another site to launch or embed a customized map with little or no code to write.
• Controlling in an <iframe> or Popup: Embed a TerriaJS application in iframe or pop it up in a separate window, and control it by posting it cross-window messages.

Special deployment configurations:

• Running TerriaMap through a reverse proxy: How to configure Terria to work correctly when running through a reverse proxy that performs path rewriting to prefix a path to URLs. E.g. hosting a map to be accessed at http://example.com/my/terriamap/