Overview
This error may appear when attempting to reset Softstream from the Softdrive platform.
Error Message
Reset Softstream error: failed to run cmd: Process exited with status 1 msg: error: Guest agent is not responding: QEMU guest agent is not connected
This indicates that the QEMU Guest Agent inside the virtual machine is not responding to the host, preventing the Softdrive platform from executing the reset command.
In most cases, this occurs because network security controls (such as a firewall, endpoint protection, or network filtering) are blocking the communication required between the VM and the Softdrive infrastructure.
Common Causes
The most common reasons for this error include:
- Firewall or Security Appliance Blocking Traffic
Network firewalls or security gateways may block required ports used by Softdrive communication services. - Endpoint Security / EDR Restrictions
Endpoint security solutions may block communication or prevent the guest agent service from responding correctly. - Network Filtering or DPI Inspection
Some networks with deep packet inspection or filtering policies may interfere with the communication required for the guest agent. - Corporate Network Restrictions
Strict corporate network policies may prevent the VM from maintaining the connection required by the Softdrive host.
Troubleshooting
1. Verify Network Connectivity
Confirm that the machine can reach the Softdrive infrastructure without restrictions.
If the machine is on a corporate or restricted network, try connecting from:
A different network
A mobile hotspot
A home network
This can help determine if the issue is caused by the network environment.
2. Verify Firewall Rules
Ensure that the required Softdrive ports and services are allowed through the firewall.
Please review the following articles for full network configuration requirements:
3. Restart the Virtual Machine
Restarting the VM can restore the guest agent connection.
You can restart the machine from the Softnet Dashboard.
4. Verify Security Software
If your environment uses endpoint protection or EDR tools, confirm that they are not blocking Softdrive services or VM communication. Please review the following article.
EDR and Anti-Virus Allow listing
Support
If the issue continues after verifying network and firewall configuration, please open a support request and include:
The error message
The Computer ID
A description of your network environment (corporate network, VPN, home network, etc.)
Please contact Softdrive Support: