GitHub - Resgrid/Dispatch: Resgrid Dispatch is a dedicated application for dispatchers to create and manage calls\incidents and unit responses for users of the Resgrid system

Resgrid Dispatch an Ionic progressive web application (pwa), mobile app and Electron app that is intended for Dispatchers for Computer Aided Dispatch (CAD) user interface for Resgrid.

About Resgrid

Resgrid is an open-source Computer Aided Dispatch (CAD) solution for first responders, businesses and industrial environments.

Configuration

You will need to create a .env file

// .env
BASE_API_URL=
API_URL=
CHANNEL_URL=
CHANNEL_HUB_NAME=
LOG_LEVEL=
OSM_MAP_KEY=
GOOGLE_MAPS_KEY=
LOGGING_KEY=

Settings

.env Values

Setting	Description
BASE_API_URL	The base URL to talk to the Resgrid API (Services) for our hosted production system this is "https://api.resgrid.com"
API_URL	The version api path for the BASE_API_URL for the hosted system the default is "/api/v4"
CHANNEL_URL	The URL to connect to the SignalR hub for our hosted production system this is "https://events.resgrid.com/"
CHANNEL_HUB_NAME	The SignalR hub name to connect to receive events for. The hosted system default is "eventingHub"
LOG_LEVEL	Log level for the Ngx-ResgridLib library: 0 = Debug and above, 1 = Warn and above, 2 = Error only, -1 = Off
OSM_MAP_KEY	API Key for MapTiler.com
GOOGLE_MAPS_KEY	API Key for Google Maps, ensure the geocoding forward and reverse permissions and apis are available to it.
LOGGING_KEY	Sentry.io logging key

Docker Deployment

Building the Docker Image

# Build the Docker image
yarn docker:build

# Or using docker directly
docker build -t resgrid-dispatch-web .

Running with Docker

Copy the example environment file:

cp .env.docker.example .env.docker

Edit .env.docker with your configuration values.
Run the container:

# Using yarn script
yarn docker:run

# Or using docker-compose
yarn docker:up

Docker Environment Variables

The following environment variables can be set at runtime (no rebuild required):

Variable	Default	Description
`DISPATCH_BASE_API_URL`	`https://api.resgrid.com`	Base URL for the Resgrid API
`DISPATCH_API_VERSION`	`v4`	API version
`DISPATCH_RESGRID_API_URL`	`/api/v4`	API path
`DISPATCH_CHANNEL_HUB_NAME`	`eventingHub`	SignalR events hub name
`DISPATCH_REALTIME_GEO_HUB_NAME`	`geolocationHub`	SignalR geolocation hub name
`DISPATCH_LOGGING_KEY`	``	Logging API key
`DISPATCH_APP_KEY`	``	Application key
`DISPATCH_MAPBOX_PUBKEY`	``	Mapbox public key
`DISPATCH_SENTRY_DSN`	``	Sentry DSN for error tracking
`DISPATCH_COUNTLY_APP_KEY`	``	Countly analytics app key
`DISPATCH_COUNTLY_SERVER_URL`	``	Countly server URL
`DISPATCH_MAINTENANCE_MODE`	`false`	Enable maintenance mode

Docker Commands

# Build image
yarn docker:build

# Run container with environment file
yarn docker:run

# Start with docker-compose (detached)
yarn docker:up

# Stop docker-compose services
yarn docker:down

# View logs
yarn docker:logs

Manual Docker Run

docker run -d \
  -p 3000:80 \
  -e DISPATCH_BASE_API_URL=https://api.resgrid.com \
  -e DISPATCH_API_VERSION=v4 \
  -e DISPATCH_MAPBOX_PUBKEY=your_mapbox_key \
  --name resgrid-dispatch \
  resgrid-dispatch-web

Pull from Docker Hub

docker pull resgridllc/dispatch