Canvas

The 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 Canvas. URL Rewrite is only needed if you set up a reverse proxy to the backend.

To link your 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 Backend 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 Backend 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 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