Rasterex Canvas

The Rasterex Canvas is the primary web interface. The installer creates an IIS website to host it.

• Installation path: C:\Program Files\RasterexCanvas
• IIS Site name: Rasterex Canvas
• Default binding: http://localhost:4203
• Includes web.config for Angular routing (no URL Rewrite module needed)

The Canvas bundle includes a web.config file that handles application routing.

This means you do NOT need to install the URL Rewrite module for the Rasterex Canvas. URL Rewrite is only needed if you set up a reverse proxy to the backend.

To link your Rasterex Canvas to the required services, you must update the service discovery URLs in the main configuration file.

Path: C:\Program Files\RasterexCanvas\www\assets\scripts\rxconfig.js

Configure Rasterex Backend first, then return here to set both service URLs. Finish with the local verification checklist.

Do not leave a hosted Viewsoft or Rasterex URL enabled for a customer deployment. The Canvas must point to the customer's own Rasterex Engine and Rasterex Backend endpoints.

• gui360URL: The Canvas-to-engine path used by the installed release; preserve the shipped value unless the customer deployment requires a different path.
• baseURL: The customer Rasterex Engine URL (must include a trailing slash).
• apiBaseURL: The customer Rasterex Backend URL (must include a trailing slash and omit the /api suffix).

// Edit these existing values in the installed rxconfig.js file.
var gui360URL = "rxweb/"; // Preserve the installed path unless instructed otherwise.
var baseURL = "https://your-backend-engine-host/";
var apiBaseURL = "https://your-rasterex-backend-host/";

// Keep the remainder of the installed RxConfig structure unchanged.

// Before testing:
// 1. Remove or replace any server.viewsoft.io, test.rasterex.com,
//    sandbox.rasterex.com, or rxserver.rasterex.com value.
// 2. Save rxconfig.js.
// 3. Reload or restart the Canvas IIS site when required by the release.

Confirm the Rasterex Canvas is running correctly.

• Browse to http://localhost:4203/
• Check IIS Manager -> Sites -> Rasterex Canvas
• Verify the site is Started and the binding is correct
• Continue to the local verification checklist after both service URLs are configured.

If the site does not load, check these common problems.

• Port 4203 in use - Change the binding in IIS or stop the conflicting application
• IIS not installed - Enable IIS with Static Content feature
• Site not started - Start the site in IIS Manager