How to Run BackupMyOrg in IIS Mode

How to Run BackupMyOrg in IIS Mode

Introduction

Running IIS mode is a configuration option that allows BackupMyOrg to be accessed via a standard web URL, rather than the default 8500 port, which provides a more streamlined and secure deployment. This setup is ideal for organizations looking to host BackupMyOrg behind a reverse proxy with support for enterprise authentication methods like ArcGIS logins or managed roles. Further context on reverse proxies can be located here. This configuration option allows for your BackupMyOrg setup to run on domain.com/backupmyorg instead of domain.com:8500.

In this guide, you’ll learn how to correctly setup your BackupMyOrg files, install the required IIS modules, configure the application in Internet Information Services Manager (IIS), and enable reverse proxy routing.

Step-by-Step Guide

  1. Unzip BackupMyOrg
    You can unzip to C:\BackupMyOrg or any other desired directory location. Since the files (served on the client-side) will reside in the BackupMyOrg\html directory, it is advised to keep the folder out of the default inetpub\wwwroot directory and set the webpage up as an application item.

  2. Install MongoDB-windows-*.exe if needed. The .exe file is located in the following directory:

Your BackupMyOrg root directory/installs
  1. Install Required IIS Modules
    In the C:\BackupMyOrg/installs/IISstandalone folder, there are two files: rewrite_amd64_en-US.msi and requestRouter_amd64.msi. These IIS modules must be installed, in the listed order, for the BackupMyOrg application to work properly. They are used by the application to create a reverse proxy to begin forwarding requests through IIS to the server application.

  2. Install & start Windows Service as noted in the BackupMyOrg standard installation.

  3. In IIS: Under your machine name -> Sites -> Default Web Site, right click Add Application (Connections or left-panel in IIS)

    1. Specify the name backupmyorg as the Alias

    2. Make the Physical Path C:\BackupMyOrg\html or wherever you have unzipped BackupMyOrg. Make sure the html directory is added.

    3. This will access BackupMyOrg from yourdomain.com/backupmyorg or localhost/backupmyorg

image-20250717-145106.png
Application Setup in IIS (must right-click Default Web Site)
  1. IIS: Enable Application Request Router (ARR) proxy

    1. Under Connections (left-panel in IIS), click on the server entry under the start page.

    2. In the center panel under the IIS section, double click on the Application Request Routing icon, so that your domain, <domain>/backupmyorg/api, properly reroutes to the http://127.0.0.1:8500.

      Application Request Routing in IIS
    3. Click the enable proxy checkbox in the center panel, then on the right panel click the apply button.

      Enabling Proxy in Application Request Routing
  1. In C:\BackupMyOrg\html\config\config.json, set "iisMode": true,

  2. You can now open a browser to (https://yourdomain.com/backupmyorg) and use the application.

  3. Since this URL will be available over the web and not on a specific port, we recommend you set up useArcGISAuth.enabled = true or use Managed Roles to access BackupMyOrg as noted here: How to Enable ArcGIS Login and Create Managed Roles in Backup My Org

If you have any questions or are experiencing any issues while following the step-through, please reach out to our GEO Jobe Support Team at support@geo-jobe.com.