• Log in to the Kuika platform.
• Open the Configuration Manager module.

• After clicking the “Create a blank configuration” button, give the configuration a name.
• In the Connection Settings section, configure the DB Connection String settings to enable the application’s access to the server.

• Add your backend URL to the Backend URL field.
• Click the SAVE button to save the settings.

• Select the project from the Apps screen.

• Click the three dots next to the “Preview” button and select the option.
• Once publishing is complete, the frontend and backend ZIP files will be sent to the specified email address.
• Extract the ZIP files to the standard IIS directory: 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 Bundle.

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 theHost Name field and check "Require server name display ”.
• Use IIS > Browse website to check that the frontend is running.

2. 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.

• URL Rewrite Rule Name Conflicts:
  
  • Open theWeb Config file and change the React Router Routes rule name.
• Folder Authorization:
  
  • Right click onFrontend and Backend folders and grant Security > IIS Users > Full Control permission.
• Backend 500.30 Error:
  
  • Connection String: Check Kuikaappdb and Kuikacommondb fields in appsetting.json file.
  • .NET 8: Install the package https://dotnet.microsoft.com/en-us/download/dotnet/8.0 . 
  • 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.