KB0082 - Why is PSU listening on port 5000 even though it is not configured to?

KB0082 - Why is PSU listening on port 5000 even though it is not configured to?

Background

You have PSU setup using only HTTPS (typically on port 443) by way of the appsettings.json file located in $Env:ProgramData\PowerShellUniversal[1].


Problem

The PSU instance is listening on two ports: the default port of 5000 and the port you configured for HTTPS (typically 443).


Root Cause

Settings not defined in $Env:ProgramData\PowerShellUniversal\appsettings.json can be inherited from the appsettings.json file in the PSU application folder (typically ${Env:ProgramFiles(x86)}\Universal on Windows).


Solution

Modify the appsettings.json file in the PSU application folder (typically ${Env:ProgramFiles(x86)}\Universal) to match your desired configuration (in this scenario, to remove the default HTTP endpoint on port 5000).


Alternative Workaround

If you are not able to modify the appsettings.json within the PSU application folder, then as a workaround you can try defining HTTP in the $Env:ProgramData\PowerShellUniversal\appsettings.json to another port (e.g. port 80 or something else that is blocked by your firewall).


    • Related Articles

    • KB0074 - Connecting to PSU API w/Windows Auth

      Scope This article applies only to PSU environments where Windows Authentication[1] is enabled and known to be working[2]. Problem You are not able to interact with the PSU instance using the Invoke-WebRequest PowerShell cmdlet even though logging in ...
    • KB0013 - Moving PSU to another server

      Below are Adam's comments on this topic from August 2nd, 2022: The configuration for PowerShell Universal, including the license, is stored as PS1 files in the repository directory. https://docs.powershelluniversal.com/config/repository We recommend ...
    • KB0015 - Offline PSU server has slow dashboards

      Disclaimer Please be careful with changing any settings on your server around the Certificate Revocation List. You should only do this if you know what you are doing. Read the related Github articles (linked below) in their entirety. Symptom PSU ...
    • KB0032 - (Windows) About the difference between the MSI and ZIP installs

      Question What's the difference between the MSI and ZIP installations of PowerShell Universal for Windows operating systems? Answer The MSI install is a self-contained web hosting platform using Microsoft Kestrel[1]. The ZIP installer is intended for ...
    • KB0011 - Are licenses different between Production, QA and Test/Development servers?

      Update January 24th, 2023 Adam recently summarized the Developer's license per below: The only real limitation on the developer license is that it cannot be accessed remotely. The server is only available on loopback when using the dev license. If ...