PowerServer 2025 Help
Config & deploy

To modify the settings for the local Kestrel server:

A local Kestrel server is configured by default. You can modify its settings such as the host name, port number, and/or HTTP/HTTPS connection method.

1. In the PowerServer project painter, select Deploy > Basic tab.

2. Select Within the IDE run mode.

   • You can directly use the default settings or modify the host name, port number, and/or HTTP/HTTPS connection method for the local Kestrel server. These settings will be used when the local Kestrel server starts within the PowerBuilder IDE or in the Development hosting environment. To change these settings, you can either 1) modify the settings here and then deploy the project again, or 2) modify the PowerServer C# Solution > ServerAPIs project > Properties > launchSettings.json > "applicationUrl" setting (if you don't want to deploy the project again).

   • The App URL and the Web API site URL are automatically generated based on the host name, port number, and connection method.

   
   
   

To create a server profile for IIS:

Make sure you have set up the IIS server correctly by following instructions in Setting up the local IIS server or Setting up a remote IIS server.

1. Click the Server Profile button on the PowerServer Toolkit toolbar.

2. In the Server Profiles window, click the New button to create a new server profile (you can also select an existing server profile on the left and then modify the settings on the right, or delete the server profile).

   
   
   

3. In the New Server Profile window, create the profile with the following settings.

   1. Modify the profile name as needed.

   2. Select IIS (using Web Deploy) from the Type list.

   3. Configure the IIS connection.

      Server: The IP address or machine name of the IIS server. The port is by default 8172. If you have changed the port, specify the port here.

      Site name: The IIS web site where files will be deployed.

      User name: The user name that has permissions to read and write the specified site. The user can be a Windows user or IIS manager. For more, refer to this page.

      Password: The user password that has permissions to read and write the specified site.

      To connect with a local IIS server, if the current Windows user has permissions to read and write the site location, you can leave User name and Password blank.

      Click Validate Connection to make sure the connection is successful.

      Note

      If you intend to deploy to the local IIS server, make sure you run PowerBuilder as administrator or have read and write permissions to the site location (read and write permissions are required when transferring files to the local server).

   4. Specify the site URL. If you want to run the application from the Run Project button, you will need to specify the site URL, and make sure the URL points to where files will be deployed, for example, http://172.16.100.35:80.

      The site URL will be used to formulate the application URL and the Web API URL automatically (the client app will be deployed with the Web API by default).

      If you have not specified the site URL, you will have to formulate the application URL manually (view more); and the Web API URL will be http://localhost by default (it can be changed later in the client app).

   5. Click OK.

      The server profile will be created and listed in the Server Profiles window.

   
   
   

To import or export the IIS server profile:

• In the Server Profiles window, click the Import or Export button to import or export an IIS server profile.

  The server profile will be saved in the JSON file format.