MMGIS

Features

Map Visualization

• 2D/3D rendering - Leaflet-based 2D maps and Cesium/Lithosphere-powered 3D globes with synchronized views
• Immersive viewers - High-resolution imagery viewer, photospheres, 3D models, PDFs, and videos
• Custom projections - Support for planetary projections and custom coordinate systems
• Terrain visualization - Tiled height data generation

Data & Layers

• 10 layer types - Vector, Tile, Image, Model, Vectortile, Velocity, Video, Data, Header, and Query layers
• Rich data formats - GeoJSON, Shapefiles, GeoTIFF, COG, OBJ, GLTF, and more
• Vector/raster tile serving - MVT tile generation with PostGIS backend
• TiTiler integration - Serve Cloud-Optimized GeoTIFFs (COGs) on-the-fly with dynamic styling and band combinations
• TiTiler STAC mosaicking - Automatically mosaic multiple COGs from STAC catalogs into seamless, queryable layers
• STAC catalogs - Spatiotemporal Asset Catalog integration for discovering geospatial data
• Dynamic styling - Property-based styling with gradients, discrete values, and geologic patterns
• Hierarchical organization - Nested layer groups with visibility and opacity controls

Interactive Tools

• Animation - Create animated GIFs and MP4s from map sequences
• Chemistry - Visualize chemical composition data from planetary samples
• Curtain - Display ground-penetrating radar subsurface imagery
• Draw - Multi-user collaborative vector drawing with real-time synchronization
• Identifier - Query pixel values from rasters and point data
• Info - Display feature properties and metadata
• Isochrone - Terrain traversability analysis and reachability mapping
• Kinds - Configure layer-specific click behaviors
• Layers - Manage layer visibility, ordering, and properties
• Legend - Auto-generated legends from layer styling and metadata
• Measure - Distance measurements, elevation profiles and line-of-sight analysis
• Query - Spatial and attribute queries across datasets
• Shade - Solar/Orbiter/Body illumination and shadow visualization via NAIF's SPICE
• Sites - Quick navigation bookmarks and saved viewpoints
• TimeControl - Time-enabled data visualization with temporal queries
• Viewshed - Line-of-sight visibility analysis

Collaboration & Sharing

• Real-time collaboration - WebSocket-based synchronization across multiple users
• Live drawing sync - See teammate edits as they happen
• Layer notifications - Automatic updates when administrators modify layers
• Configuration coordination - Conflict detection for multi-admin editing

Mission Management

• Easy-to-use CMS - Graphical configuration interface for mission setup
• Flexible authentication - Local accounts, OAuth2/SSO, or open access modes
• Role-based access - SuperAdmin, Admin, and User permission levels
• Mission-specific access - Control which users can view and edit each mission
• API token management - Long-term tokens for programmatic access
• Multiple missions - Host multiple independent mapping projects

Advanced Features

• Temporal data - Time-based layer filtering and animation
• Elevation profiling - Extract terrain profiles along paths
• Spatial queries - PostGIS-powered geospatial analysis
• Geodataset management - Upload, index, and serve large vector/raster datasets
• Custom tile generation - Scripts for creating optimized tilesets
• Plugin architecture - Extend functionality with custom tools and backends
• Webhook integration - Connect MMGIS to external systems and workflows

Installation

It is recommended to setup MMGIS via docker. However, if you would like to setup MMGIS without docker, please check out: https://nasa-ammos.github.io/MMGIS/setup/installation#installing-without-docker

/ will always refer to the repo's root directory.

Building

Point to a prebuilt image in your docker-compose.yml: https://github.com/NASA-AMMOS/MMGIS/pkgs/container/mmgis

Or build it locally for a custom build:

1. Clone the repo
   git clone https://github.com/NASA-AMMOS/MMGIS

2. Run: docker build -t <image tag> .

Preparing

.env

• Copy /sample.env to .env
cp sample.env .env

• Open .env and update the following:

  DB_NAME=<name>
  DB_USER=<user>
  DB_PASS=<password>
  

  From the install example:

  DB_NAME=db
  DB_USER=postgres
  DB_PASS=<POSTGRES_PASSWORD (see below)>
  

• Set all the ENV variables in .env. More information about the ENVs can be found here.

  • If using the postgis/postgres image from within the docker-compose.yml, set the ENV DB_HOST to the name of the service (in this case db)

docker-compose.yml

This repo contains a /docker-compose.sample.yml file that defines a service for the application and a PostgreSQL database with PostGIS installed

• Copy this file to a docker-compose.yml.
• In the db service in docker-compose.yml, set the POSTGRES_PASSWORD environment variable and use this for MMGIS's DB_PASS ENV value.
• Fill out the other environment variables within the docker-compose.yml as well.
• Note, the /docker-compose.sample.yml includes optional STAC and TiTiler services. If any of them are unwanted, they can be removed from the docker-compose-yml and their respective .env variable WITH_{service} can be set to false.

Running

Run: docker-compose up -d

Stopping

Run: docker-compose down

First Time UI Setup

1. Setup the admin account:

   • In your browser, navigate to https://{your-mmgis-domain}/configure
   • Sign up for an Administrator account (The Administrator account is always the first user in the database and you are only prompted to create an Administrator account if there are no other users)

2. Now sign in with your Administrator credentials

3. Click NEW MISSION
   Enter a new mission name and click MAKE MISSION

Navigate to https://{your-mmgis-domain}/.

See the configuration documentation for more information on how to use the configure page to customize and add data to MMGIS.

Plugins

MMGIS uses a plugin-based architecture organized under /plugins/ in a three-level hierarchy: <container>/<type>/<PluginName>/. Core plugins ship with MMGIS; external plugins can be installed from Git repositories or local paths without modifying the core codebase. Git repos are cloned into plugins/<org>--<repo>/ (double-hyphen separator) to avoid name collisions across organizations.

Official Plugin Repository

Community and mission-specific plugins are maintained in the official collection:

NASA-AMMOS/MMGIS-Plugins

Install the official plugins with:

npm run plugins -- install MMGIS-Plugins

Plugin Types

Plugin CLI

Manage plugins via the built-in CLI:

npm run plugins -- list                    # List all plugins
npm run plugins -- install <git-url|path>  # Install a plugin repo
npm run plugins -- uninstall <repo-name>   # Uninstall a plugin repo
npm run plugins -- enable <plugin-id>      # Enable a plugin
npm run plugins -- disable <plugin-id>     # Disable a plugin
npm run plugins -- create <type> <Name>    # Scaffold a new plugin
npm run plugins -- validate                # Validate all manifests

See plugins/README.md for the full CLI reference, plugin.json manifest format, and development guide.

Minimum Specs

License: Apache 2.0

https://www.apache.org/licenses/LICENSE-2.0

Copyright (c) 2026, California Institute of Technology ("Caltech"). U.S. Government sponsorship acknowledged.

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
• Redistributions must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
• Neither the name of Caltech nor its operating division, the Jet Propulsion Laboratory, nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Contacts

Dr. Fred J. Calef III - [email protected]
Tariq K. Soliman - [email protected]

Or join us on Slack