MachPanel Knowledgebase

Hotfix for MachPanel Build v8.2.50 HF Updated (April 10, 2026)

rehan_waseem — Mon, 13 Apr 2026 08:41:46 GMT

Summary

This article provides 8.2.50 HF and information about how to apply this fix on your servers.

Applies To

This article applies to MachPanel

Important Note

Prior to performing any update take backup of your MachPanel Database and files from Control and Remote servers. See below Kb article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
MachPanel Control Panel and all MachPanel Remote Servers need to be on Build v8.2.50 and then Hotfix can be applied.
Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:
- Update to Latest MachPanel
- Update to Latest MachPanel Remote Server

Latest Issues Fixed

Build: 8.2.50 HF Updated: April 10, 2026

1. Added method in REST API to change Mailbox type.
2. Added methods in REST API to manage Mailbox calendar permissions.
3. Fixed VPS IP only addon not getting provisioned.
4. Fixed VPS disk options in Add VPS.
5. Optimized/Enhanced Exchange Distribution Group Members management.
6. Dynamic IP allocation handled for Linux VMs.
7. Fixed edit VPS addon throwing an exception due to missing Natted IP record.
8. Added Export AD users CSV option in Update Bulk AD User.
9: Added Copy to Clipboard option in Selectable/Select control.

Procedure

Go to MachPanel configuration studio.
Shut down all the MachPanel services and also exit the configuration studio. Make sure no instance to MachPanel Configuration Studio is running under any user.

Download the hotfix MachPanel_HF_8.2.50_Apr_10_2026.zip file from the link at bottom of this page.
Stop IIS Admin Service, please make sure that all the services are STOPPED from MachPanel Configuration Studio. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service.

MachSol.MachPanel.ConfigurationStudio.exe.

MachPanel Billing Service.

MachPanel Helpdesk Service.

MachPanel Network Service.

MachPanel License Service.

MachPanel O365 Service.

Replace files from MachPanel folder on MachPanel control server (Path: C:\Program Files\MachSol\MachPanel Control Server) and Replace files from Remote server folder of hotfix folder on MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) keeping the folder hierarchy same as it is in hotfix. (you should get message to overwrite files, if not you are not doing it right).
Execute script.txt from zip file on MachPanel_Db after logging in to SQL management studio as MachPanel_Db user.

Once all files are replaced properly from hotfix folder Restart all services related to MachPanel on Control as well as Remote Servers.

Download Link

https://www.machsol.com/updates/8250/MachPanel_HF_8.2.50_HF_Apr_10_2026.zip

Note: Please Unblock the files before replacing in installation directory if the downloaded Zip folder is blocked.

Logging on Hyper-V Remote Server

rehan_waseem — Fri, 10 Apr 2026 15:12:36 GMT

Summary

This article provides a summary on MachPanel Hyper -V Logs files for Remote servers.

Applies To

This article applies to MachPanel build v8.2.50 and above.

Enable Extensive Logging via MachPanel:

AttachVHDLog_<date>

Is for all operations related to attaching a VHD to a virtual machine including initialization, configuration validation, disk attachment on the SCSI controller, and final status. Any exceptions encountered during execution are also recorded.

BandWidthMonitering_<date>:

Records network bandwidth utilization metrics for virtual machines within the Microsoft Hyper-V environment. This file is generated when bandwidth monitoring is enabled for a virtual machine and is used to track network activity over time.

It captures both upload and download traffic separately, providing visibility into inbound and outbound data transfer for each monitored VM. The recorded data helps in understanding network consumption patterns, identifying high-traffic workloads, and ensuring fair usage of shared network resources.

JobProcessingLog_<date>

Is for the virtual machine provisioning process on the Microsoft Hyper-V server. It captures a detailed, step-by-step record of all operations performed during VM creation, like creation of the virtual machine directory and storage path, selection and configuration of the VM generation, attachment of the sealed image (VHD/VHDX), allocation of compute resources, and network configuration such as virtual switch assignment and NIC setup.

Any warnings, exceptions, or failures encountered during execution are also recorded.

Overall, this log file provides end-to-end traceability of the VM creation lifecycle.

ProvSvc-RemoteConfigurationStudio_<date>

This indicates that the Provisioning Service (ProvSvc) has initiated a process. Typically, this log appears when the service starts up, or task/job (such as configuration, deployment, or sync) is triggered.

Prov_SVC_<date>

This usually logs when the system attempts to process a job. For e.g. The process is already stopped, or process was never running, or process ID/name could not be found.

Remote_<date>

This log shows that a remote PowerShell command was executed. The command queries the Windows Management Instrumentation (WMI) to collect CPU (processor) details from the target machine. It is typically used by monitoring/provisioning systems (like MachPanel) to gather system resource information.

Remote configuration Studio_<date>

These logs indicate a MachPanel Remote Server update process initialization. It shows the version to which it is updated. The update was successful or failure. In case of update failure it will show the error or cause of failure.

VPS_<date>

Provides an abstracted, high-level view of the processing status for individual virtual machine files (XML) within the provisioning workflow on the Microsoft Hyper-V environment.

VMUsageStateLog

Maintains a structured, time-series record of resource utilization metrics for virtual machines hosted on the Microsoft Hyper-V environment. The data is stored in JSON format, where each entry corresponds to a specific virtual machine identified by its unique VMID and VMName.

For each virtual machine, the log captures a collection of UsageStats entries recorded at periodic intervals. These entries include key performance indicators such as CPU usage, memory (RAM) consumption, and disk (HDD) utilization, along with an associated UTC timestamp (DateStamp) indicating when the metrics were collected.

This log enables historical tracking of VM resource consumption over time, facilitating performance monitoring, capacity planning, and trend analysis. It also supports identifying usage patterns, detecting anomalies (e.g., sudden spikes in CPU or memory), and correlating system behavior with operational events.

This structured JSON format allows easy integration with monitoring tools, reporting systems in MachPanel for both real-time observation and retrospective analysis of virtual machine performance.

VMUsageState

Is for the virtual machine resource monitoring process within the Microsoft Hyper-V environment. It records the execution details of the ReadVMStatsAndSaveInFile() routine, which is responsible for collecting and persisting VM usage statistics.

This log captures timestamped entries that document both successful operations and runtime exceptions encountered during the data collection process. Common logged activities include reading VM resource metrics, calculating virtual disk consumption, and writing aggregated statistics to the VMUsageState data file.

VMDownTime (folder)

Contains the VMDownTime file that maintains a record of virtual machine downtime events within the Microsoft Hyper-V environment. It captures essential details for each instance where a virtual machine is identified as unavailable or not running.

PFSense Deployment & Integration Prerequisites (Hyper-V Environment)

mudesira.munir — Wed, 01 Apr 2026 15:39:06 GMT

Summary

It describes how to integrate and deploy PFsense in Machpanel Hyper-V environment.

Applies To

Applies to MachPanel build v 8.2.50 and above

Overview

This document outlines the prerequisites and key configuration requirements for deploying pfSense in a Hyper-V environment and integrating it with MachPanel. Adhering to these guidelines ensures consistency, scalability, and seamless operation, especially in high-availability (HA) setups.

1. PFSense Deployment on Hyper-V

Deploy pfSense as a virtual machine on Hyper-V hosts by following the official Netgate documentation:  https://docs.netgate.com/pfsense/en/latest/recipes/virtualize-hyper-v.html
Ensure that the VM is provisioned with appropriate resources (CPU, RAM, and storage) based on expected workload and tenant usage.

2. Network Interface Configuration

Configure network interfaces in pfSense as per deployment requirements.
Maintain consistent interface naming and ordering across all pfSense instances (Primary and HA peers).

Important:  Consistent interface naming and ordering are critical for proper synchronization between pfSense nodes in high-availability configurations.
Reference Topology.

3. REST API Configuration (for MachPanel Integration)

Install the pfSense REST API package.
Generate and securely store the API key, which will be required for MachPanel integration. Reference:  https://github.com/pfrest/pfSense-pkg-RESTAPI

4. Virtual Switch & Interface Alignment

Ensure that the Hyper-V virtual switch name matches the corresponding pfSense interface name used for tenant communication.
Recommended naming convention: "TENANTS" (ensure correct spelling and consistency across all systems)

Important:  The naming must be identical across:

Hyper-V Virtual Switch
pfSense Interface This is required for proper mapping and automation via MachPanel.

5. Trunk Configuration

Configure the "TENANTS" virtual switch on Hyper-V as a trunk port.
This allows multiple VLANs to pass through and enables tenant-level network segmentation.

6. High Availability Considerations

For HA deployments:
Apply identical configurations across all pfSense nodes.
Ensure:

Interface naming consistency
Matching virtual switch configurations
Proper synchronization settings

Failure to maintain consistency may result in sync failures or unpredictable behavior.

MachPanel Cloud Networking - Software Defined Network Integration for pfSense

zohaib.shaikh — Thu, 26 Mar 2026 06:13:43 GMT

Summary

This article provides information regarding "Cloud Networking" feature in MachPanel, that is Software Defined Network handling for pfSense and Hyper-V

Applies To

Applies to MachPanel version v8.2.50 and above.

Overview

MachPanel now supports integration with pfSense, enabling automated management of network services such as NAT, firewall rules, and IP routing for virtual machines via newly added "Cloud Networking" section.

This enhancement allows administrators to seamlessly connect MachPanel with pfSense to automate network configuration during VM provisioning and management.

Key Features

Automated NAT rule creation
Firewall rule management
Integration with VM provisioning workflow
Centralized network control via pfSense
Reduced manual configuration effort

Pre-Requisites

pfSense Configuration Pre-requisites:
- One time pfSense deployment and configuration is required on Hyper-V server / servers. This deployment will serve as a multi-tenant pfSense setup for all your customers hosted via MachPanel giving you and your customers total control, automation and cost saving..
  - Setup/Install pfSense on your Hyper-V Server. Review following KB article on pfSense Deployment & Integration Prerequisites (Hyper-V Environment)
MachPanel Configuration Pre-requisites:
- Dynamic IP Allocation for Private Pool IPs is required to be configured in MachPanel before configuring pfSense in MachPanel.
  - To do that, navigate to Virtual Machine Hosting > Server Group.
    - From the Options click Subnet Pools
    - Click Add Subnet Pool
      - Give Name
      - Choose Type to 'Private'
      - Choose the Allocation type to 'Dynamic'
      - Select Virtual Switch 'Tenants'
      - Give VLAN ID
      - Choose the checkbox 'Use for Single VPS Hosting Products', if you want to create this Pool for Single VM Plan.
      - Select 'All'
      - Click Save.

MachPanel Cloud Networking / pfSense Configuration

A new configuration section is introduced to connect MachPanel that allows you to add pfSense servers called the "Cloud Networking".

Add Server

Click Add Server button to add your pfServer server details and associate the Server Group and customers:

Give Server Name.
Select Provider as "PfSense"
Select the Server Group to associate pfSense with.
Tick the checkbox 'High Available Member' (If you have HA Setup)
- Choose Role
  - Master
  - Slave
Give your API URL and API Key. (How to configure pfSense API)
Tick the checkbox to enable this Server.
Click Save.

Manage Interfaces

Next step is to configure or manage the "Interfaces" which are already configured in pfSense.

The interface setup on your backend Hyper-V Server will be shown here.
You can choose the interface and tick the respective 'Used For' for particular interface. You can choose either of the shown interface types for any particular interface:
- OTHERS (interfaces not designated for specific use, such as LAN or other interfaces)
- WAN (interface designated for WAN)
- Tenants (interface designated for TENANTS)
  - If tenants is selected then you have to select it for any particular customer or ALL.

Click Save.

Public IPs

To add Public IPs click Add/Edit Public IPs

You can Select Server.
Select the Interface
Give list of Comma separated IPs
Select the Subnet

Click Save

Now you can Provision a VM for a specific customer.

Virtual Networks

Once VM is provisioned against a customer, you can navigate to "Add VNet" interface to Add Virtual Network against desired customers:

Select the Customer against which you have added VM, then Select your Server and Click Save.

You can also manage/Edit DNS for particular customer virtual network.

Aliases

To add Aliases navigate to below section and click 'Add Alias' against a particular customer.

Select Customer
Give Alias name
Give Discription
Choose Type
- Host(s)
- Network(s)
- Ports(s)
Later you can Edit, View or Remove any alias as well.

Firewall Rules

To add firewall rules to a specific VM of customer, navigate to below interface and click Add Firewall Rule

Select Customer
Select Interface that you have created for this customer
Give Description
Choose Action
- Pass
- Block
- Reject
Choose Protocol
- Any
- TCP
- UDP
- TCP/UDP
- Source and Destination can be choosen upon your requirements 'Any or any specific Interface'
Click Save

You can also set the Priority as well.

Static DHCP Mapping

As in DHCP, the IP of VM might get changed automatically after every reboot. So, here you can assign Static IP for any particular VM of a customer so that it does not get changed after every reboot. To set you can navigate to below interface, it will show details about the VM of your customer.

Click Assign Static IP
Choose the IP you want to assign to the VM of customer as static
Click Assign

NAT Rules

To add NAT Rules, you first have to assign Static IP to the VM. Then navigate to below interface and click Add NAT Setting

Select Customer
Give Description
Enabled NAT
The IP you have given as static will be shown in drop down
Choose the Protocol
- Any
- TCP
- UDP
- TCP/UDP
Choose the Source from drop down
Select the Public IP to which you want to translate/map the private IP of this customer VM
Click Save

Dynamic IP Assignment to VM (Backend Managed)

zohaib.shaikh — Wed, 25 Mar 2026 07:55:00 GMT

Summary

MachPanel now supports Dynamic IP Assignment for Virtual Machines, where IP configuration (IP address, Gateway, DNS) is automatically managed by the backend instead of manual allocation.

Applies To

This article applies to MachPanel version v8.2.50 and above.

Overview

This enhancement simplifies VM provisioning and reduces manual network configuration effort.

Key Concept

There are now two types of IP allocation in Subnet Pools:

Static IP (Default)
- Traditional Method
- Admin manually assign IP, Gateway, DNS
Dynamic IP
- Fully managed by backend
- No manual IP assignment required

*Note: Dynamic IP is supported only for Private IP Pools. Public IP Pools remains Static.

Subnet Pool Configuration

A new option is added in Subnet Pool settings to define IP assignment type.

Important Notes

Once a subnet is created, IP type cannot be changed later
When Dynamic is selected:
- No IP addresses need to be defined
- IP entries cannot be added, edited, or deleted

VM Replication Support Handling in MachPanel

zohaib.shaikh — Wed, 25 Mar 2026 06:25:57 GMT

Summary

MachPanel now includes enhanced support for Virtual Machine (VM) replication, enabling more efficient management of replicated environments within Hyper-V infrastructures.

Applies To

This article applies to MachPanel version v8.2.50 and above.

Overview

This enhancement introduces improved handling of VM replication workflows, allowing administrators to better manage, monitor, and maintain replicated virtual machines directly from the MachPanel interface.

Key Features

Replication Awareness
- MachPanel can now detect and recognize replicated virtual machines, ensuring accurate status visibility.
Improved Management Controls
- Administrators can perform actions on replicated VMs with better consistency, avoiding conflicts between primary and replica instances.
Seamless Integration with Hyper-V
- Enhanced compatibility with Hyper-V replication ensures that changes in replication state (e.g., failover, failback) are properly reflected within MachPanel.
Error Handling and Stability
- Improved handling of replication-related scenarios reduces failures during provisioning, synchronization, and VM operations.

Server Group Configuration

A new checkbox has been added in Server Group configuration to enable replication settings.

Server Configuration

Each server can now be assigned a role in replication.

VM Provisioning Behavior

Virtual Machine Provisioning logic now ensures that VMs are only created on valid Active servers.

Auto Detection of VM Location

MachPanel now intelligently detects if a VM has moved and updates records accordingly.

MachPanel Build v8.2.50 Release Notes (April 02, 2026)

zohaib.shaikh — Mon, 16 Mar 2026 14:42:36 GMT

Content

Important Prerequisites/Upgrade Instructions
Important Notes
Major Enhancements
Improvements/New Features
Resolved/Fix Issues

1. Important Prerequisites

Customers using old module like Exchange 2010, Exchange 2010 Hosted, should NOT update to MachPanel v8.
If you are already running MachPanel Build 8.0.32, then this prerequisite is already there. If you are updating from an older build, then you must need to download Microsoft .Net Framework 4.8 on control and remote servers. Once downloaded you can run the installer to install .Net framework 4.8 following below steps:

After the installation of .Net Framework 4.8 your server will require a restart. You can click on 'Restart Now' button.

Also, it is recommended to use the latest version of browsers (Chrome, Firefox and Edge) and MachPanel HelpDesk Service should be disabled before starting the Auto Update Process.

Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:

2. Important Notes

If you are using MachPanel Rest API, please follow link below to update to latest version of Rest API:

Update to Latest MachPanel REST API

Do note that if REST API is installed by MachPanel installer under C:/Program Files/Machsol/RESTAPI and it is operational in your environment, then auto update will update RESTAPI files as well. Manual update is needed when RESTAPI is installed on other than default location.

Important Note for MachPanel Load Balanced Setup after the Update.

If you are already running MachPanel Build 8.0.32, then this prerequisite is already there. If you are updating from an older build and you are using MachPanel Load Balanced setup then you must follow below steps after the update:

Locate MachPanel app pool in IIS, open Advanced Settings and select .NET CLR version v4.0, restart app pool and web app.

Copy Web.Config file from Primary Control Server (C:\Program Files\MachSol\MachPanel Control Server) to all your Secondary Servers.
Also, make sure all others files are updated on Secondary Servers, if not then you have you update all files from Primary Control Server to all Secondary Server by stopping all MachPanel services including MachPanel Configuration Studio on all Server and stopping MachPanel App Pool and MachPanel Website.

3. Major Enhancements

4. Improvements/New Feature

General (MachPanel, AD, Configuration Studio, REST API, HelpDesk):

Audit logs improved for Active Directory module.
Restricted access to SPLA reports for Owner's company Staff users with Super Admin role only.
Added New AD User Password Policy settings.
Restricted access to Customer account for certain Staff Roles
Added User Type filter in AD Users listing.
Configured AD Authentication for Staff Users.
Added enhancement to return JobId in Add Entity API methods.
Updated DUO WebSDK integration.

Microsoft Exchange:

Audit logs improved for Exchange Module.
Added new mailbox user Password Policy settings.
Increased the Message Size limit during Mailbox Import processing.
Added enhancement in Audit logs search for Mailbox-Specific-Action.
Improved Mail Flow reports with Fault Tolerance.
Improved Add Mailbox retries for handling DB deadlock victim error.
Logging added for MailFlow Logs processing failure tracking.
Added -ShowDetails in Mailbox Audit Logs export command.
Added enhancement for UPN, CN and SAM case is retained as per input in AD and Ex module.

Microsoft Hyper-V:

Improved Memory Weight field in VPS plans for Reseller & Customer.
Added VM Scheduled Management Operation (Turn On/Off).

5. Resolved / Fixed Issues

General (MachPanel, AD, Config Studio, REST API, HelpDesk):

Fixed extra modules show up in customer side without subscribing.
Fixed AD User add issue when there's no user in organization to set as Manager.
Fixed error in creating/updating Linked Ad User Contact for Customer.
Fixed error on Set As Home Page action in German language.
Fixed REST API edit AD User function.
Fixed user attributes cleared on enabling Mailbox for existing ADUser.
Fixed AD Expired accounts report.
Marked required field with * in Customer Contact Add/Edit.
Fixed Active Directory Groups not listing users correctly.

Microsoft Exchange:

Fixed the issue of mailbox not getting disabled having Audit Enabled.
Fixed Sanitization issue in Exchange Disclaimer text.
Fixed Auto Disable/Enable Mailbox on ADUser Disable/Enable not working.
Fixed error in Ex Settings interface "FirstName" Column not found.
Fixed Mailbox template gets updated from mailbox Edit Interface.
Allowed Simple DL member add in Simple DL members.
Handled error "This task does not support recipients of this type." in create mailbox job processing.
Fixed Mailbox display text.
Fixed Required parameter missing error in enabling Mailbox for existing AD User imported from backend or O365.

Microsoft Hyper-V:

Fixed long delay in Get All VMs Endpoint.
Fixed 'Manage' VM button issue from Customer Login.

Microsoft CSP:

Fixed error in Tenant Management User detail and other tabs.
Updated message on missing GDAP relation for tenants imported in panel.
Fixed CSP Grant Consent Issue.

CSP Grant Consent Error

rehan_waseem — Thu, 15 Jan 2026 11:18:15 GMT

Summary

The article give information about solving the issue of CSP Grant Consent after the Window Update KB5071544

Applies to

MachPanel v8 and above

Issue Details

After the below windows update

https://support.microsoft.com/en-us/topic/december-9-2025-kb5071544-os-build-17763-8146-630aa62e-f399-4e42-9f7a-2a4d38dd1210

Below issue might come while granting consent for CSP tenant in MachPanel.

Resolution

To fix the issue below steps should be followed:

Go to the installation directory of MachPanel Control Server (C:\Program Files\MachSol\MachPanel Control Server).
Open Web.Config in notepad.
Find <httpRuntime>
Replace it with below:
- <httpRuntime targetFramework="4.8" executionTimeout="1800" maxRequestLength="102400" maxQueryStringLength="16384" maxUrlLength="16384" />
Apply changes and restart IIS.

Hotfix for MachPanel Build v8.1.22 HF Updated (March 27, 2026)

mudesira.munir — Wed, 24 Dec 2025 07:44:35 GMT

Summary

This article provides 8.1.22 HF and information about how to apply this fix on your servers.

Applies To

This article applies to MachPanel

Important Note

Prior to performing any update take backup of your MachPanel Database and files from Control and Remote servers. See below Kb article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
MachPanel Control Panel and all MachPanel Remote Servers need to be on Build v8.1.22 and then Hotfix can be applied.
Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:
- Update to Latest MachPanel
- Update to Latest MachPanel Remote Server

Latest Issues Fixed

Build: 8.1.22 HF Updated: March 27, 2026

1: Fixed extra modules show up in customer side without subscribing.
2: Fixed MailFlow logs break if one of Ex server is down.
3: Logging added for MailFlow Logs processing failure tracking.
4: Added -ShowDetails in Mailbox Audit Logs export command.
5: Fixed AD User add issue when there's no user in organization to set as Manager
6: Fixed Sanitization issue in Exchange Disclaimer text.
7: Fixed long delay in Get All VMs Endpoint.
8: Fixed error in creating/updating Linked Ad User Contact for Customer.
9: Fixed Auto Disable/Enable Mailbox on ADUser Disable/Enable not working.
10:Disable/Delete operations allowed for mailboxes whose AuditEnabled is On.
11:Fixed error in Ex Settings interface "FirstName" Column not found.
12:Fixed error on Set As Home Page action in German language.
13:Fixed default password policy selected is not getting applied on new AD User creation.
14:Fixed MB template gets updated from mailbox detail, edit section hidden.
15:Allowed Simple DL member add in Simple DL members.
16:UPN, CN and SAM case is retained as per input in AD and Ex module.
17:DUO WebSDK integration updated.
18:Fixed REST API edit AD User function.
19:Fixed user attributes cleared on enabling Mailbox for existing ADUser.
20:Handled error "This task does not support recipients of this type." in create mailbox job processing.
21:Updated handling to avoid/reduce "Deadlock Victim" error in Active Directory and Exchange Module.
22:Fixed AD Expired accounts report.
23:Fixed Mailbox display text.
24:Marked required field with * in Customer Contact Add/Edit.
25:Fixed Required parameter missing error in enabling Mailbox for existing AD User imported from backend or O365.
26:Fixed error in Tenant Management User detail and other tabs.
27:Fixed Active Directory Groups not listing users correctly.
28:Updated message on missing GDAP relation for tenants imported in panel.
29:Fixed error '"{0}" is not a valid email address' in O365 Security Group Management.

Procedure

Go to MachPanel configuration studio.
Shut down all the MachPanel services and also exit the configuration studio. Make sure no instance to MachPanel Configuration Studio is running under any user.

Download the hotfix MachPanel_HF_8.1.22_Mar_27_2026.zip file from the link at bottom of this page.
Stop IIS Admin Service, please make sure that all the services are STOPPED from MachPanel Configuration Studio. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service.

MachSol.MachPanel.ConfigurationStudio.exe.

MachPanel Billing Service.

MachPanel Helpdesk Service.

MachPanel Network Service.

MachPanel License Service.

MachPanel O365 Service.

Replace files from MachPanel folder on MachPanel control server (Path: C:\Program Files\MachSol\MachPanel Control Server) and Replace files from Remote server folder of hotfix folder on MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) keeping the folder hierarchy same as it is in hotfix. (you should get message to overwrite files, if not you are not doing it right).
Execute script.txt from zip file on MachPanel_Db after logging in to SQL management studio as MachPanel_Db user.

Once all files are replaced properly from hotfix folder Restart all services related to MachPanel on Control as well as Remote Servers.

Download Link

https://www.machsol.com/updates/8122/MachPanel_HF_8.1.22_Mar_27_2026.zip

Note: Please Unblock the files before replacing in installation directory if the downloaded Zip folder is blocked.

MachPanel Build v8.1.22 Release Notes (December 08, 2025)

zohaib.shaikh — Thu, 27 Nov 2025 20:40:53 GMT

Content

Important Prerequisites/Upgrade Instructions
Important Notes
Major Enhancements
Improvements/New Features
Resolved/Fix Issues

1. Important Prerequisites

Customers using old module like Exchange 2010, Exchange 2010 Hosted, should NOT update to MachPanel v8.
If you are already running MachPanel Build 8.0.32, then this prerequisite is already there. If you are updating from an older build, then you must need to download Microsoft .Net Framework 4.8 on control and remote servers. Once downloaded you can run the installer to install .Net framework 4.8 following below steps:

After the installation of .Net Framework 4.8 your server will require a restart. You can click on 'Restart Now' button.

Also, it is recommended to use the latest version of browsers (Chrome, Firefox and Edge) and MachPanel HelpDesk Service should be disabled before starting the Auto Update Process.

Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:

2. Important Notes

If you are using MachPanel Rest API, please follow link below to update to latest version of Rest API:

Update to Latest MachPanel REST API

Important Note for MachPanel Load Balanced Setup after the Update.

Locate MachPanel app pool in IIS, open Advanced Settings and select .NET CLR version v4.0, restart app pool and web app.

Copy Web.Config file from Primary Control Server (C:\Program Files\MachSol\MachPanel Control Server) to all your Secondary Servers.
Also, make sure all others files are updated on Secondary Servers, if not then you have you update all files from Primary Control Server to all Secondary Server by stopping all MachPanel services including MachPanel Configuration Studio on all Server and stopping MachPanel App Pool and MachPanel Website.

3. Major Enhancements

Optimized client JS front end and ASP.Net backend to improve performance of control panel both on client and server side. Customers having organizations with 10K+ users will have better user experience with the control panel.
Exchange Subscription Edition integration added.

4. Improvements/New Feature

General (MachPanel, AD, Configuration Studio, REST API, HelpDesk):

Updated REST API mailbox-permissions method to sync data in database/interface.
Standardized behavior for Customer/Reseller buttons.
Customer contact email handling updated, verification is added based on customer AD users.
Profile Picture update support added via MachPanel interface for ADSync enabled users.
Show most recent Provider first in Add Package (all applicable modules).
Updated domain change flow.
Updated backup routine to skip *.PST files when the import folder contains large locked files.
Quantity increase/decrease and deletion for add-ons in REST API.
Improved API validation.
Updated CustomAttributes handling.

Microsoft Exchange:

Restricted Application Impersonation role to Shared Mailboxes.
Added Basic OWA Policy auto assignment for mailboxes using the Basic template.
Added option to import mailboxes from backend under mailboxes management.
Added per-organization option to disable/enable mailbox on ADUser Disable/Enable.

Microsoft Hyper-V:

Added option to connect Web Console with and without Enhanced Mode for Windows VMs.
Enhanced Sealed Image Add/Edit interface to Support Legacy (Copy-VMFile) and NoCloud ISO Options

5. Resolved / Fixed Issues

General (MachPanel, AD, Config Studio, REST API, HelpDesk):

Fixed issue in Load Balanced REST API file sync routine.
Fixed auto backup not working in Configuration Studio.
Fixed Login With Azure issue when Linked with AD Staff User Account.
Fixed pager not working in Audit Logs listing.

Microsoft CSP:

Fixed product selected in package missing in O365 Subscription detail and renewal settings.
Fixed admin relationship role assignment in O365 management.

Microsoft Hyper-V:

Fixed ISO image checkbox display.

Hotfix for MachPanel Build v8.0.50 HF Updated (November 06, 2025)

rehan_waseem — Mon, 15 Sep 2025 16:50:57 GMT

Summary

This article provides 8.0.50 HF and information about how to apply this fix on your servers.

Applies To

This article applies to MachPanel

Important Note

Prior to performing any update take backup of your MachPanel Database and files from Control and Remote servers. See below Kb article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
MachPanel Control Panel and all MachPanel Remote Servers need to be on Build v8.0.50 and then Hotfix can be applied.
Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:
- Update to Latest MachPanel
- Update to Latest MachPanel Remote Server

Latest Issues Fixed

Build: 8.0.50 HF Updated: November 06, 2025

1: Updated REST API set mailbox permissions method to sync data in database/interface.
2: Fixed pager not working in Audit Logs listing.
3: Fixed ISO image checkbox display.
4: Fixed Full Access permissions for mailbox not working.
5: Import Mailboxes from backend added.
6: Fixed issue in Load Balanced RESTAPI file sync routine.
7: Fixed mailboxes with Basic SPLA reported as Standard mailbox due to wrong OWA Mailbox Policy assigned.
8: Added option to connect Web Console with and without Enhanced Mode Setting for Windows VM.9: Fixed product selected in package mssing in O365 Subscription detail and renewal settings.10: Fix admin relationship role assignment added in O365 management.11: Fixed auto backup not working in Configuration Studio.12: Issue of Login With Azure Linked AD Staff User Account Fixed.

Procedure

Go to MachPanel configuration studio.
Shut down all the MachPanel services and also exit the configuration studio. Make sure no instance to MachPanel Configuration Studio is running under any user.

Download the hotfix MachPanel_HF_8.0.50_Nov_06_2025.zip file from the link at bottom of this page.
Stop IIS Admin Service, please make sure that all the services are STOPPED from MachPanel Configuration Studio. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service.

MachSol.MachPanel.ConfigurationStudio.exe.

MachPanel Billing Service.

MachPanel Helpdesk Service.

MachPanel Network Service.

MachPanel License Service.

MachPanel O365 Service.

Replace files from MachPanel folder on MachPanel control server (Path: C:\Program Files\MachSol\MachPanel Control Server) and Replace files from Remote server folder of hotfix folder on MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) keeping the folder hierarchy same as it is in hotfix. (you should get message to overwrite files, if not you are not doing it right).
Execute script.txt from zip file on MachPanel_Db after logging in to SQL management studio as MachPanel_Db user.

Once all files are replaced properly from hotfix folder Restart all services related to MachPanel on Control as well as Remote Servers.

Download Link

https://www.machsol.com/updates/8050/MachPanel_HF_8.0.50_Nov_06_2025.zip

Note: Please Unblock the files before replacing in installation directory if the downloaded Zip folder is blocked.

Update MachSol Signature Agent 09 September 2025

rehan_waseem — Tue, 09 Sep 2025 13:31:01 GMT

Summary

This article provides details on how to update your Machsol Signature Agent to its latest version.

Note

This is a new and additionally paid feature, licenses for which can be acquired from MachSol Customer Portal / Store. Please contact MachSol Sales for more information.

Applies To

MachPanel build version 8 and above

Pre-Requisites

MachPanel Signature Agent must be installed using below KB article:

https://kb.machsol.com/Knowledgebase/55789/MachSol-Signature-Agent-

Improvements/Fixes

Added input to define Signatures for External and Internal messages or for both.
Added Distribution List for applying signatures, making management easier.
Time limit added to schedule Signatures for Disclaimers and banners.
Added preview is Signature Listing.
Added clone option to duplicate and update signatures easily.
Added setting to customize if Sent Email should be updated or not.
"X-MachPanel-MessageSignaturesProcessed" added in email header to mark the email and skip in futher processing.

Procedure

Take backup of existing files
- Go to your installation directory of MachSol Signature Agent.
- Copy the complete folder MachSol Signature Agent
- Create a new Backup directory and place this copied folder inside this backup folder
Stop Service
- Open Services and stop Microsoft Transport Service

Download the latest files from THIS link
- Copy all the inside the update folder and replace them inside the installation directory of MachSol Signature Agent
Start the Microsoft Transport Service.

MachPanel Build v8.0.50 Release Notes (September 09, 2025)

rehan_waseem — Wed, 03 Sep 2025 20:41:46 GMT

Content

Important Prerequisites/Upgrade Instructions
Important Notes
Improvements/New Features
Resolved/Fix Issues

1. Important Prerequisites

Customers using old module like Exchange 2010, Exchange 2010 Hosted, should NOT update to MachPanel v8.
If you are already running MachPanel Build 8.0.32, then this prerequisite is already there. If you are updating from an older build, then you must need to download Microsoft .Net Framework 4.8 on control and remote servers. Once downloaded you can run the installer to install .Net framework 4.8 following below steps:

After the installation of .Net Framework 4.8 your server will require a restart. You can click on 'Restart Now' button.

Also, it is recommended to use the latest version of browsers (Chrome, Firefox and Edge) and MachPanel HelpDesk Service should be disabled before starting the Auto Update Process.

Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:

2. Important Notes

If you are using MachPanel Rest API, please follow link below to update to latest version of Rest API:

Update to Latest MachPanel REST API

Important Note for MachPanel Load Balanced Setup after the Update.

Locate MachPanel app pool in IIS, open Advanced Settings and select .NET CLR version v4.0, restart app pool and web app.

Copy Web.Config file from Primary Control Server (C:\Program Files\MachSol\MachPanel Control Server) to all your Secondary Servers.
Also, make sure all others files are updated on Secondary Servers, if not then you have you update all files from Primary Control Server to all Secondary Server by stopping all MachPanel services including MachPanel Configuration Studio on all Server and stopping MachPanel App Pool and MachPanel Website.

3. Improvements/New Feature

General (MachPanel, AD, Configuration Studio, REST API, HelpDesk):

Customers can manage Active-Sync devices per user from control panel
Added option to enable/disable servers in bulk
Added “Resend Code” Option for PIN via SMS and Email in Online Store Two-Factor Authentication
Added ADUser report in REST-API.
Files restriction in file upload implemented on all locations allowing upload, allowed types are: pdf,doc,docx,xls,xlsx,csv,ppt,pptx,txt,rtf,odt,jpg,jpeg,png,gif,bmp,svg,tiff,webp,zip,rar,7z,tar,gz,mp3,wav,mp4,mov,avi,mkv
DotNet page execution from cache folder is restricted.
Connection string in 3rd party import settings is now encrypted.
Updated SimpleDisplayName of mailbox using Set-User command.
Updated file upload, input values sensitization and other security updates.
Updated error handling in AD Bulk update operation, added validation for empty mandatory fields when retain existing data is un-checked
Updated users navigation on AD Organization Listing >> User Count link.
Hidden "Next Renewal" Column on Subscriptions Page When Billing Module is Disabled (Customer & Reseller View)
Handled replication delay error that might cause password policy update failure when creating new AD Users
Added automation for REST API files to be auto updated in Load Balanced Control Server Deployment
Added logging for REST API operations on disk. Handled Get request logging to disk
Added details of "Account Used" for REST API calls in audit log
Load balancer setup handling added for REST API OAuth.

Exchange

Added option to Change Public Folder Mailbox database
Added setting of External Forwarding
Added priority High parameter in Import/Export Mailbox PST commands
PS injection handling updated for multi-line inputs and more use cases, input is sanitized and encoded to avoid PS execution, PS injection attacks.
Updated REST API, permissions (SendAs, SendOnBehalf, FullAccess) for Mailbox and Distribution List can be cleared now by passing empty list
Added option to Load Mailbox Templates based on Templates sold in add-ons
Removed unnecessary Organization Drop-down in “Add PST Export Job” under Exchange Accounts → Manage Service
Exchange Import Utility Improvements added . The nested OUs will not be shown
Handled + and # symbols in LDAP of Mailbox, DL, Contact.
"+" handled in DL email address, can create a DL like all+@domain.com.
Update X-MachPanel-MessageSignaturesProcessed in Signature processing. Please update the agent using THIS link.

VPS/Hyper-V

Added Notes Option in VM Management Checkpoints Section

SharePoint

Added option for adding existing AD users to SharePoint portal in bulk

Signature Agent

Note: MachSol Signature Agent on Exchange Servers need to be updated using link.

Added input to define Signatures for External and Internal messages or for both.
Added Distribution List for applying signatures, making management easier.
Time limit added to schedule Signatures for Disclaimers and banners.
Added preview is Signature Listing.
Added clone option to duplicate and update signatures easily.
Added setting to customize if Sent Email should be updated or not.
"X-MachPanel-MessageSignaturesProcessed" added in email header to mark the email and skip in further processing.

4. Resolved / Fixed Issues

General (MachPanel, AD, Config Studio, REST API, HelpDesk):

Fixed checkbox Misalignment on MFA Login Screen
Fixed login Redirection (global search) Fails with Data Type Conversion Error
Fixed update Email Subject and Body for Re-authentication Secret Notification
Fixed proxy Settings & License Update Error in Remote Configuration Studio
Fixed PIN code Checkbox alignment at Customer Login to Online Store
Fixed customer Login Fails to Online Store with Duo Authentication – Upgrade to Duo Universal Prompt Required
Fixed error on Customer Login to Online Store – MFAPINRequestEmail not found on SubscriptionEmails
Fixed error on AD User Login via PIN (Email/SMS) and Authentication app – Object reference not set to an instance of an object
Fixed customer can buy add-ons though access permission is not allowed.
Fixed duplicate users display in AD Groups management.
Fixed conversion error when Login button is clicked on Global Search Results.
Fixed error in logging in when DUO authentication is used.
Fixed AD Group jobs not updating data on backend.
Fixed AD Organization list that shows no records if Remove Organization permission is not allowed.

Exchange

Fixed Mailbox Status Link Redirects to Blank Page After Provisioning Completes
Fixed Mailbox Full Access Auto Mapping not showing correctly or Full Access status keeps on syncing.
Fixed Mailbox device tab giving error when a device not found.
Fixed Duplicate records in DL ManagedBy when adding multiple Exchange DLs in one go.
Fixed Mobile Device Listing not working.
Fixed Mobile Device listing all Devices related to Mailboxes interface not listing records.
Fixed error in adding SMTP domain when the language is other then English.
Fixed Mobile Device listing missing some records against Mailbox. Also changed Identity display to show only Device identity part.
Fixed Suspected PS injection error in Mailbox OOO settings.
Fixed error in Get DL members in REST API when there is no member.
Fixed error System.InvalidOperationException: Cannot de-serialize type 'BusinessObjects.Hosting.ServiceMangement.ExchangeManagement+Forwarding.
Fixed error in SimpleDisplayName update in Exchange module.
Fixed error Operation failed.parsing "(href|src)\s*=\s*['"]?\s*javascript:|data:|vbscript:)[^'">]*['"]?" - Too many )'s. in package add/edit.
Fixed wrong variables in disclaimer body.
Fixed DL SendOnBehalf not accepting DL email.
Fixed X500 addresses not valid.
Fixed updating template of mailbox updates CAS settings twice which causes issue randomly if command executes on different servers.

VPS/Hyper-V

Fixed no IPs found error in VPS import.

O365/Microsoft CSP

Fixed search domain and company not working in O365 import.

Configuring Autodiscover SRV Record for Outlook Connectivity

rehan_waseem — Mon, 11 Aug 2025 09:28:42 GMT

Summary

This article provide information about how to configure auto discover SRV record for Outlook Connectivity.

Applies To

All Versions.

Steps Procedure

Kindly make sure DNS (escpeically autodiscover) is properly configured for your customer organization.

Following is required to have successful autodiscovery:

_autodiscover._tcp.example.com. 3600 IN SRV 0 0 443 mail.example.com.

Please create SRV record as per above format for tenant domain.

SRV Record: Create SRV record in each tenant public DNS zone with given format.

Note: Make Sure you do not have any CNAME with name autodiscover in tenant DNS zone.

After making changes (if they were not already there) give DNS propagation some time and check your outlook connectivity again.

Hotfix for MachPanel Build v8.0.32 HF Updated (September 1, 2025)

rehan_waseem — Mon, 26 May 2025 11:30:07 GMT

Summary

This article provides 8.0.32 HF and information about how to apply this fix on your servers.

Applies To

This article applies to MachPanel

Important Note

Prior to performing any update take backup of your MachPanel Database and files from Control and Remote servers. See below Kb article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
MachPanel Control Panel and all MachPanel Remote Servers need to be on Build v8.0.32 and then Hotfix can be applied.
Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:
- Update to Latest MachPanel
- Update to Latest MachPanel Remote Server

Latest Issues Fixed

Build: 8.0.32 HF Updated: September 1, 2025

1: Fixed Mailbox Full Access Auto Mapping not showing correctly or Full Access status keeps on syncing.
2: Fixed Mailbox device tab giving error when a device not found.
3: Fixed Duplicate records in DL ManagedBy when adding multiple Exchange DLs in one go.
4: "+" handled in DL email address, can create a DL like all+@domain.com.
5: Fixed Customer can buy addons though access permission is not allowed.
6: Fixed Mobile Device Listing not working.
7: Fixed Mobile Device listing all Devices related to Mailboxes interface not listing records.
8: Updated error handling in AD Bulk update operation, added validation for empty mandatory fields when retin existing data is un-checked.
9: Added priority High parameter in Import/Export Mailbox PST commands.
10:Fixed error in logging in when DUO authenticator is used.
11:Fixed error in adding SMTP domain when the language is other then English.
12:Fixed Mobile Device listing missing some records against Mailbox. Also changed Identity display to show only Device identity part.
13:Fixed Suspected PS injection error in Mailbox OOO settings.
14:No IPs found during VPS import fixed.
15:Updated PS injection check to allow ";" in input password.
16:Fixed AD Group jobs not updating data on backend.
17:Added logging for REST API operations on disk. Handled Get request logging to disk.
18:Fixed error in Get DL members in REST API when there is no member.
19:Update PS injection checks to handle more scenarios.
20:Added logging to disk for REST API handling all type of Requests.
21:Fixed error System.InvalidOperationException: Cannot deserialize type 'BusinessObjects.Hosting.ServiceMangement.ExchangeManagement+Forwarding.
22:PS injection handling updated for multi-line inputs and more use cases, input is santized and encoded to un-wanted avoid PS execution.
23:Fixed AD Orgs list show no records if Remove Org permission not allowed.
24:Updated users navigation on AD Orgs Listing User count link.
25:Handled replication delay error that might cause password policy update failure when creating new AD Users.
26:Fixed Duplicate users display in AD Groups management.
27:Fixed conversion error when Login button is clicked on Global Search Results.
28:Fixed search domain and company not working in O365 import.
29:Added ADUser report in REST-API.
30:Fixed wrong variables in disclaimer body.
31:Files restriction in file upload implemented, allowed types are: pdf,doc,docx,xls,xlsx,csv,ppt,pptx,txt,rtf,odt,jpg,jpeg,png,gif,bmp,svg,tiff,webp,zip,rar,7z,tar,gz,mp3,wav,mp4,mov,avi,mkv
32:DotNet page execution from cache folder is restricted.
33:Connection string in 3rd party import settings is encrypted.
34:Updated SimpleDisplayName of mailbox using Set-User command.
35:Updated file upload, input values santization and other security updates.
36:Fixed error in SimpleDisplayName update in Exchange module.
37:Fixed error Operation failed.parsing "(href|src)\s*=\s*['"]?\s*javascript:|data:|vbscript:)[^'">]*['"]?" - Too many )'s. in package add/edit nad HeldpDesk emails processing.
38:Updated REST API, permissions (SendAs, SendOnBehalf, FullAccess) for Mailbox and Distribution List can be cleared now by passing empty list.
39:Fixed DL SendOnBehalf not accepting DL email.
40:Fixed X500 addresses not valid.41:Load balancer setup handling added for REST API OAuth.
42:Fixed updating template of mailbox updates CAS settings twice which causes issue randomly if command executes on different servers.

Procedure

Go to MachPanel configuration studio.
Shut down all the MachPanel services and also exit the configuration studio. Make sure no instance to MachPanel Configuration Studio is running under any user.

Download the hotfix MachPanel_HF_8.0.32_Sep_1_2025.zip file from the link at bottom of this page.
Stop IIS Admin Service, please make sure that all the services are STOPPED from MachPanel Configuration Studio. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service.

MachSol.MachPanel.ConfigurationStudio.exe.

MachPanel Billing Service.

MachPanel Helpdesk Service.

MachPanel Network Service.

MachPanel License Service.

MachPanel O365 Service.

Replace files from MachPanel folder on MachPanel control server (Path: C:\Program Files\MachSol\MachPanel Control Server) and Replace files from Remote server folder of hotfix folder on MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) keeping the folder hierarchy same as it is in hotfix. (you should get message to overwrite files, if not you are not doing it right).
Execute script.txt from zip file on MachPanel_Db after logging in to SQL management studio as MachPanel_Db user.

Once all files are replaced properly from hotfix folder Restart all services related to MachPanel on Control as well as Remote Servers.

Download Link

https://www.machsol.com/updates/8032/MachPanel_HF_8.0.32_Sep_1_2025.zip

Note: Please Unblock the files before replacing in installation directory if the downloaded Zip folder is blocked.

MachPanel Knowledgebase

Hotfix for MachPanel Build v8.2.50 HF Updated (April 10, 2026)

Summary

Applies To

Important Note

Latest Issues Fixed

Procedure

Download Link

Logging on Hyper-V Remote Server

AttachVHDLog_<date>

JobProcessingLog_<date>

ProvSvc-RemoteConfigurationStudio_<date>

Prov_SVC_<date>

Remote_<date>

Remote configuration Studio_<date>

VPS_<date>

VMUsageStateLog

VMUsageState

PFSense Deployment & Integration Prerequisites (Hyper-V Environment)

Summary

Applies To

Overview

1. PFSense Deployment on Hyper-V

2. Network Interface Configuration

3. REST API Configuration (for MachPanel Integration)

4. Virtual Switch & Interface Alignment

5. Trunk Configuration

6. High Availability Considerations

MachPanel Cloud Networking - Software Defined Network Integration for pfSense

Summary

Applies To

Overview

Key Features

Pre-Requisites​

MachPanel Cloud Networking / pfSense Configuration

Dynamic IP Assignment to VM (Backend Managed)

Summary

Applies To

Overview

Key Concept

Subnet Pool Configuration

VM Replication Support Handling in MachPanel

Summary

Applies To

Overview

Key Features

Server Group Configuration

Server Configuration

VM Provisioning Behavior

Auto Detection of VM Location

MachPanel Build v8.2.50 Release Notes (April 02, 2026)

Content

1. Important Prerequisites

2. Important Notes

3. Major Enhancements

4. Improvements/New Feature

5. Resolved / Fixed Issues

CSP Grant Consent Error

Summary

Applies to

Issue Details

Resolution

Hotfix for MachPanel Build v8.1.22 HF Updated (March 27, 2026)

Summary

Applies To

Important Note

Latest Issues Fixed

Procedure

Download Link

MachPanel Build v8.1.22 Release Notes (December 08, 2025)

Content

1. Important Prerequisites

2. Important Notes

3. Major Enhancements

4. Improvements/New Feature

5. Resolved / Fixed Issues

Hotfix for MachPanel Build v8.0.50 HF Updated (November 06, 2025)

Summary

Applies To

Important Note

Pre-Requisites