Documentation for Deploying .
NET Core
Awash API
This documentation outlines the steps required to deploy a .NET Core API application on a
Windows Server environment using IIS. It includes steps for installing necessary software,
configuring IIS, and setting up firewall rules.
Step 1: Add IIS Role and Features
1. Open 'Server Manager' on your Windows Server machine.
2. Click on 'Manage' and select 'Add Roles and Features'.
3. In the 'Add Roles and Features Wizard', click 'Next' until you reach the 'Roles' section.
4. Select 'Web Server (IIS)' and click 'Next'.
5. Under 'Role Services', ensure that the following features are selected:
- Web Server
- Web Server > Application Development > .NET Extensibility
- Web Server > Application Development > ASP.NET
- Web Server > Management Tools > IIS Management Console
6. Complete the wizard and install IIS.
7. Once installed, you can verify the installation by opening IIS Manager.
Step 2: Install .NET Core SDK 8.0.11
1. Download the .NET Core SDK version 8.0.11 from the official .NET website:
https://dotnet.microsoft.com/download/dotnet-core
2. Run the installer and follow the on-screen instructions to complete the installation.
3. After installation, you can verify it by opening Command Prompt and typing:
dotnet --version
This should return the installed version (e.g., 8.0.11).
Step 3: Install ASP.NET Core Module 2 Hosting Bundle
1. Download the ASP.NET Core Module 2 Hosting Bundle from the official .NET website:
https://dotnet.microsoft.com/download/dotnet-core/current/runtime/aspnetcore-
runtime-2.x
2. Run the installer and follow the installation steps to install the necessary components for
hosting ASP.NET Core apps in IIS.
3. Once installed, restart IIS using the following command:
iisreset
Step 4: Configure Application Pool for Database
1. Open IIS Manager.
2. In the left pane, click on 'Application Pools'.
3. Right-click on the 'DefaultAppPool' (or create a new pool) and select 'Advanced Settings'.
4. In the 'Advanced Settings' window, set the following properties:
- .NET Framework version: Set this to '.NET Framework v4.7' or higher.
- Identity: Set this to a custom identity if required (e.g., a domain user with access to the
database).
5. Ensure that the application pool identity has proper access to your database by assigning
the necessary permissions.
6. Click 'OK' to save the changes.
Step 5: Configure Windows Firewall Inbound and Outbound Rules
1. Open 'Windows Firewall with Advanced Security'.
2. Click on 'Inbound Rules' on the left pane, then click 'New Rule' on the right.
3. Choose 'Port', click 'Next', and select the specific port on which the API will run (e.g.,
5000).
4. Allow the connection and select when to apply the rule (Domain, Private, or Public).
5. Click 'Next', give the rule a name (e.g., '.NET Core API Inbound'), and click 'Finish'.
6. For outbound rules, repeat the same steps under 'Outbound Rules' if the API makes
outgoing connections.
7. Make sure that the firewall settings allow traffic for your specific API port to enable
proper communication.
