Change the port used by SmartDeploy 3.0

By default; the SmartDeploy API Service will use port 8080. If you need to change this port to resolve a conflict, you can follow these steps.


  1. Open the Services.msc tool and stop the SmartDeploy API Service.
  2. Open Notepad as Administrator and open C:\Program Files\SmartDeploy\SmartDeploy\Resources\SDApiService.appsettings.json.
  3. Press Ctrl-F, search for HostUriPort. You will find a line that looks like this:

    "HostUriPort": "8080",

  4. Inside the quotation marks, change the port number (currently 8080) to the new port value that you wish to use.
  5. Save and close SDApiService.appsettings.json.
  6. Return to the Services.msc tool and start the SmartDeploy API Service.
  7. (Optional) Open your default browser and open https://localhost:####/health to test connectivity to the SmartDeploy API Service using the new port specified (in place of #### above).
  8. Open the SmartDeploy Console, and expand the Advanced options.
  9. Update the SmartDeploy Api Service URL with the new port.
  10. Enter your SmartDeploy credentials and click OK.

Note that you will need to recreate your SmartDeploy Client installer package so that it uses the updated URI with the new port. Additionally, note that any existing endpoints with the SmartDeploy Client installed will need to be updated, either by:

  • Uninstalling the client and deleting the C:\Program Files\SmartDeploy folder and then reinstalling with the updated client installer package.
  • Using a script to update the ClientConfig.json file with the new URI (Please contact SmartDeploy Support if you wish to use this option)
Still have a question or want to share what you have learned? Visit our to get help and collaborate with others.