Explanation on how to install FrameworX Designer.

Platform | Installation | Solution | Modules | Controls | Code | Troubleshooting


Overview

This section covers licensing requirements.

FrameworX Designer installation takes 1-3 minutes on Windows 10 or later. The Designer and Solution Center require .NET Framework 4.8, which is included in Windows 10+. The cross-platform runtime (Web pages, AI/MCP integration, and multi-platform solutions) requires the .NET Desktop Runtime that matches the FrameworX version: .NET 8 for 10.1.4 and earlier, .NET 10 for 10.1.5 and later.


Installation

Prerequisites

RequirementDetails
Operating SystemWindows 10 or later
PrivilegesAdministrator for installation
Disk Space4 GB minimum
.NET Framework4.8 (included in Windows 10+) — required for Designer and Solution Center
.NET Desktop RuntimeVersion depends on FrameworX: .NET 8 for FrameworX 10.1.4 and earlier, .NET 10 for FrameworX 10.1.5 and later. Required for Web pages, AI/MCP integration, demos, and multi-platform solutions.
Visual C++ Redistributable | 2015–2022 x64installed automatically by the Setup if not already present on the system

Note: The Setup automatically detects and installs the Visual C++ 2015–2022 Redistributable (x64) if it is not already present. On fresh Windows installations, this component is typically missing and will be installed silently during Setup without requiring any action from the user.



Installation Steps

.NET Desktop Runtime

Install the runtime that matches your FrameworX version:

10.1.4 and 10.1.5 can be installed side-by-side on the same machine as isolated runtimes.

FrameworX

  1. Download installer: https://tatsoft.com/fx-101/
  2. Run FrameworX-Setup.exe as Administrator
  3. Accept default settings
  4. Launch from Start Menu

Default installation path: C:\Program Files\Tatsoft\FrameworX\

Note: Uninstall previous versions before installing new ones to prevent conflicts.


Solution Center Access

MethodRequirementsDesigner Support
Windows ApplicationWindows 10+Full Designer access
Web BrowserModern browserView only
ClickOnceWindows + browserDesigner launches locally

Cross-Platform Runtime Requirements

The cross-platform runtime (Web, AI/MCP, Linux, Docker) requires the .NET Runtime that matches the FrameworX version:

  • FrameworX 10.1.4 and earlier — .NET 8  Runtime
  • FrameworX 10.1.5 and later — .NET 10 Runtime
  • Designer and Solution Center continue to require .NET Framework 4.8 (included with Windows 10+) across all versions.
  • 10.1.4 and 10.1.5 can be installed side-by-side on the same machine as isolated runtimes.
ScenarioCross-Platform Runtime RequiredNotes
Windows-only solutionsNoUses .NET Framework 4.8
Rich/Smart ClientsNoWindows clients only
Web displays (HTML5)YesWebAssembly support
Multiplatform deploymentYesLinux/Docker support
Sample solutionsRecommendedExamples target the cross-platform runtime

Download links: .NET 8 Desktop Runtime (x64) for 10.1.4 and earlier, or .NET 10 Desktop Runtime (x64) for 10.1.5 and later.

Note: If you are using a windows-only solution and creating displays portables, it is necessary to have NET 8 installed to compile the display.


Licensing

License Types

  • No License: Full development, 4-hour runtime sessions, not for production
  • Runtime License: Unlimited runtime, production authorized

Activation Methods

  • Online: Instant with internet connection
  • Offline: Air-gapped systems using request/response files
  • Hardware Dongle: USB-based, portable
  • License Server: Network floating licenses

Version Compatibility

FrameworX 10.1 is upward compatible with 10.0. Opening a 10.0 solution in 10.1 creates an automatic backup and converts to 10.1 format.


Troubleshooting

IssueCauseSolution
Installer won't startMissing prerequisitesVerify Windows version
Missing cross-platform runtime warningOptional component for Windows-only solutionsIgnore for Windows-only; otherwise install .NET 8 (10.1.4 and earlier) or .NET 10 (10.1.5 and later)
License not recognizedNetwork issueUse offline activation
Performance issuesAntivirus scanningAdd exclusions

Child Pages


System Requirements (Reference)

Hardware and software prerequisites for FrameworX deployments.

Parent Page: Installation & Licensing (Reference)


Designer Requirements

Hardware Specifications

ComponentMinimumRecommended
CPUIntel Core 2 DuoIntel Core i7
RAM4 GB16 GB
Disk2 GB HDD256 GB SSD
Display1024×7681280×1024+
OSWindows 10Windows 10+
.NETFramework 4.8Framework 4.8 + cross-platform runtime (.NET 8 for 10.1.4 and earlier, .NET 10 for 10.1.5 and later)

Runtime Requirements

Platform Comparison

SpecificationMultiplatformWindows-Only
.NET.NET 8 (FrameworX 10.1.4 and earlier) / .NET 10 (FrameworX 10.1.5 and later).NET Framework 4.8
RAM512 MB minimum2 GB minimum
Disk100 MB minimum1 GB minimum
OSLinux/Windows/DockerWindows 10+

Performance Factors

Runtime requirements depend on:

  • Tag count
  • Device connections
  • Client connections
  • Historian configuration
  • Script complexity

In this section...