User Manual

Publish App on On-Prem

30/7/25
Publish App on On-Prem

On-Prem allows the software to be hosted on the company's own physical infrastructure. In this course, you will learn the steps to publish your application in On-Prem with the Configuration Manager module.

This training content consists of the following topics:

  • Configure Configuration Manager Settings
  • Publishing the App
  • Frequently Asked Questions

Configuring Configuration Manager Settings

  • Log in to the Kuika platform.
  • Open the Configuration Manager module.
  • Provide the application access to the server by making DB Connection String settings in the Connection Settings field.
  • Add your backend URL to the Backend URL field.
  • Save the settings by clicking the SAVE button.

Publishing the Application

  • Select the project from the Apps screen.
  • Click the three dots next to the Preview button and select the option.
  • When publishing is complete, the frontend and backend ZIP files are sent to the specified email address.
  • Extract the ZIP files to the standard directory for IIS, C:\inetpub\wwwroot\.

Preparing IIS and Required Environments

  • Operating System Windows Server 2019
  • Database MS SQL Server 2019
  • Web Server IIS 10.0xx
  • Hardware Requirements: 32 GB RAM, 16 VCPUs, Xeon E5 2660 2.2 GHz
  • SSL Certificates: Must be provided for each subdomain.
  • Firewall: Allow ports 80 and 443.
  • Installations: Install URL Rewrite and .NET 8.

Building and Publishing the Application on IIS

  1. Frontend Setup:
    • Click IIS > Sites > Add Web Site.
Web UI folder must be selected for frontend installation.
  • Enter site name and select frontend files as physical path.
  • If you are using SSL, select HTTPS and specify port 443.
  • Enter the domain name in the Host Name field and check "Require server name display ”.
  • Use IIS > Browse website to check that the frontend is running.
  1. Backend Setup:
  • Create a new site for the backend following similar steps.
  • If you are using SSL, select HTTPS and specify port 443.

In Application Pool settings:

  • Right-click on the backend application pool, select Basic Settings > No Managed Code.
  • To test the backend, check if it works by adding /swagger.

Frequently Asked Questions

  • URL Rewrite Rule Name Conflicts:
    • Open the Web Config file and change the React Router Routes rule name.
  • Folder Authorization:
    • Right click on Frontend and Backend folders and grant Security > IIS Users > Full Control permission.
  • Backend 500.30 Error:
  • Incorrect application pool setting:
  • Open the Application Pools area on IIS.
  • Right-click on the Application Pool used for your backend and open Basic Settings.
  • Select “No Managed Code” for the .NET CLR Version value.
  • Network Error:
    • Edit env-config.js to add the correct URL to the BACKEND_URL field.
    • Restart the IIS > Frontend application pool.
    • For Backend URL change after Publish:
      • Press F12 and open the Developer Tool to see which Backend URL the Frontend is requesting.
      • Switch to the Network area. Check the URL from the header field in failed requests.
      • If you notice that the frontend is not accessing the backend URL correctly, go to the frontend folder on your computer.
      • Edit the “ENV_TEST” section in the env-config.js file by entering BACKEND_URL:"https://istediğinizalanadı/v1/api ” and the swagger URL directory.
      • Go back to IIS. Restart the frontend's application pool.

If it still does not go to the correct URL, do a Cache Cleanup to make sure that the updates made on the browser are reflected.

Improving Application Performance: IIS Application Pool Settings

  • Open IIS Manager.
  • Select the application pool from the Application Pools tab.
  • Right-click and set Advanced Settings > Start Mode to "Always Running ”.
  • Restart the IIS service.

If you still have problems after following these steps, you can contact the Kuika support team.

Other Related Content

No items found.

Glossary

No items found.

Alt Başlıklar