Rasterex APINPM Package/docs/installer/overview

Installer Overview

What RasterexInstaller.exe installs, the installation flow, and what to do after installation.

One Installer, Three Connected Components

Run one RasterexInstaller.exe file to install the three packages that make up a local Rasterex environment. Installation copies and registers the components; configure Rasterex Backend and Rasterex Canvas before testing the complete system.

text
Rasterex Canvas
        |
        v
Rasterex Backend
        |
        v
Backend Engine (RxView360)
One Installer, Three Connected Components

Download Releases

Download the current supported installer for new deployments and upgrades. Confirm the prerequisites below before running it.

After installation, or after any backend .env change, restart the DB backend process or service so the new configuration is applied.

Installer releases

Download the version you need

Stable
VersionRelease dateNotesDownload
4.3.0Latest
Available nowCurrent Rasterex installer for new deployments and upgrades.Download

Prerequisites

Before running the installer, ensure these requirements are met.

  • Windows Server or Windows 10/11
  • Administrator rights (Run as Administrator)
  • IIS installed with Static Content feature (required for all packages)
  • Node.js installed (required for running the db backend)

Recommended Production Server

For production environments, deploy the installer on a dedicated Windows Server host with sufficient resources for IIS, the DB backend, document processing, caching, and concurrent user activity.

  • Operating system: Windows Server 2019 or Windows Server 2022.
  • Processor and memory: Minimum 4 CPU cores and 16 GB RAM recommended.
  • Storage: Minimum 100 GB SSD recommended, with additional capacity planned for uploaded files, cache data, logs, and exported documents.
  • Network: Reliable connectivity between the web viewer, DB backend, database server, and client users.
  • Ports: IIS should be available on ports 80/443, and the DB backend uses port 5203 by default unless configured otherwise.
  • Database access: Connectivity to a supported database server: Microsoft SQL Server, MySQL, or PostgreSQL.

What is the Installer?

RasterexInstaller.exe is one self-contained Windows installer (Burn bundle). It contains three MSI packages and installs them in sequence; customers download and run only the single installer file as Administrator.

  • Backend Engine (RxView360): document viewing engine
  • Rasterex Backend: Express.js DB backend files and configuration
  • Rasterex Canvas: The user interface for viewing and interacting with documents

Installation Flow

Packages install in this order. Each must complete before the next begins.

  • 1. Backend Engine (RxView360): Interactive license UI (user must accept)
  • 2. Rasterex Backend: Copies server files to C:\Program Files\RasterexBackend
  • 3. Rasterex Canvas: Creates IIS site on port 4203

Complete the Local Setup

After the installer completes, configure the DB backend database connection, run the documented common-data seed step, and configure Canvas with the Backend Engine and DB backend URLs. Then verify the complete local system.

What the Installer Does NOT Do

After installation, additional configuration is required for production deployments.