Force a Cloud Connection

The default behavior of the SmartDeploy Client is to try to connect to the SmartDeploy console via its local API Service URI:
https://consolehostname:8080 (e.g.)

If the SmartDeploy Client is able to connect successfully, then it will appear in the SmartDeploy console with a connection type of Local, and you will be able to perform operations from Computer Management via either a Local or Cloud connection.

If the SmartDeploy Client is unable to connect successfully via the local API Service URI (which is expected if the endpoint is outside your corporate network) after 5 minutes of trying, it will automatically switch to use SmartDeploy's online API service, also known as Cloud Broker. The console will check in with the same service, and the endpoint will be listed in that specific console with a connection type of Cloud. You will then be able to perform cloud-based operations onto that endpoint.


If you have any endpoints that will always be off-site and only ever use a cloud connection, you can force the client to use the Cloud Broker service by default (and skip the 5-minute period of attempting to connect via the local APIServiceURI).

You can do this in any of the following ways: 

First, you can create a new SmartDeploy Client Installation Package that's configured to force a cloud connection (see Step 3), which can then be installed manually or via Group Policy.

Second, you can install the client during reimaging (see Step 3) with Cloud Only Connection checked in Answer File Wizard.


And finally, if you have any existing installed endpoints that you would like to reconfigure to force a Cloud connection without re-installing the SmartDeploy Client, you can do the following; 

  1. Open the Services.msc tool and stop the SmartDeploy Client Service.                                               
  2. Open Notepad as Administrator and browse to and open C:\Program Files\SmartDeploy\ClientService\ClientConfig.json
  3. Change the "ConnectionType" value to 2.                                                                                                               
  4. Save and close ClientConfig.json.
  5. Start the SmartDeploy Client Service.

We can provide a script to reconfigure an existing client installation to use a cloud connection only - contact SmartDeploy Support if you're interested.

After this change has taken effect, check the endpoint in Computer Management, and you will see the Connection Type change from Local to Cloud.

Was this article helpful?
Still have a question or want to share what you have learned? Visit our Community Discord to get help and collaborate with others.