Self Deployment Guide

The Self Deployment Guide is designed to give organizations everything they need to deploy their own EarthRanger site. By following the structured sections in this guide, you’ll be able to configure and launch EarthRanger with minimal direct support.

This guide is organized into key configuration areas that mirror the setup process:

  • Map Layer Configuration – Set up basemaps and layers that define your geographic context.
  • Event Configuration – Customize event types, categories, and workflows to match your operational needs.
  • Device Configuration – Connect and manage devices through the EarthRanger Admin and learn the procedures to integrate technology through Gundi
  • User Permissions Configuration – Define the permissions necessary for configuring your EarthRanger site 
  • Analyzer Configuration – Configure analyzers and tools to support geospatial insights and alerts.

Each section provides contextual guidance, and links to detailed resources. Together, they create a complete pathway for independently deploying EarthRanger.

If at any point you encounter challenges or find that you need additional support beyond what’s included here, please reach out to the EarthRanger Support Team for assistance.

Map Layer Configuration

Map layers define the geographic context of your EarthRanger site. In this section, you’ll configure the layers that appear on the map, organize them into categories, and import your own shapefiles or GeoJSON. You’ll also learn how to apply styling and quicklinks so your operational map is both accurate and easy to navigate.
Before you configure map layers
 

  • Decide which categories and groups your features will belong to.
  • Ensure shapefiles or GeoJSON files are validated and ready for import.
  • Plan how map quicklinks will help users access important views.

Follow These Guides

Event Configuration

Events in EarthRanger capture and structure the information your team records in the field. This section walks you through setting up event categories, designing event types, and managing choices so that the data you collect is consistent and easy to analyze. By configuring events correctly, you’ll ensure that your workflows reflect your operational needs and that users can record the right information with minimal friction.
Before you configure Events:

  • Confirm whether an Event Category already exists or needs to be created for your new Event Types.
  • Use the Event Form Editor (EFE) to design and create the Event Types you require.
  • Add choices to EarthRanger (if needed) to support dropdown fields in your Event forms.
  • Validate that the permissions linked to the Event Category and Event Types are effective by testing with a user or test account.

Follow these guides: 

Device Configuration

Device Configuration ensures that your field technology is connected to EarthRanger and properly organized for use. Some devices are configured directly in EarthRanger Admin, while others are supported through Gundi and require setup in their own system. This section walks you through both paths, so you can connect devices, validate their visibility, and assign the right permissions for your team.
Before you configure devices

  • Gather prerequisites for integration from the provider (for Gundi-supported devices, see the Gundi Help Center).
  • Confirm that Gundi permission sets, DAS application, and access tokens are available in your system by default.
  • Plan how devices will be grouped into subject groups for easier management and visibility.

 


Follow these guides: 
Configure devices in EarthRanger Admin


Integrate supported devices through Gundi


Finalize and validate

  • Validate Device Integration 
    Guidance on testing and confirming that devices are correctly integrated, visible, and grouped as expected.
     

User Permissions Configuration

User Permissions ensure that the right people (and groups) have the correct level of access to EarthRanger. In this section, you’ll configure user accounts, assign permission sets, and link those permissions to events, patrols, subjects, and map visibility. Properly setting permissions is critical to both security and usability, ensuring that staff can only view and act on the information relevant to them.
Before you configure permissions

  • Prepare a list of users and their required access levels.
  • Plan which roles or groups need visibility into events, patrols, subjects, or maps.
  • Optionally, decide whether to create profiles without password logins to reduce account sharing and improve security.
     

Follow these guides:

Analyzer Configuration

Analyzers allow EarthRanger to automatically detect and generate events when certain conditions are met, such as geofences being crossed, subjects becoming immobile, or external data (like FIRMS fire alerts) being received. This section walks you through setting up analyzers step by step, linking them to map features, subjects, and event categories so they can function correctly.
Before you configure analyzers

  • Understand how spatial and non-spatial analyzers work.
  • Import and group the map features needed for geofence or proximity analyzers.
  • Confirm that subjects you want to monitor are organized in subject groups.
  • Check that event types linked to analyzers are active and assigned to a visible category (commonly the Analyzer Event Category).


Here you’ll find how to: