Setting Up ASP.NET Core Development Environment

Introduction

Before you write a single line of ShopNest code, you need a reliable development environment. A messy setup is the #1 reason freshers abandon tutorials halfway — missing SDK workloads, wrong SQL connection strings, or Git not configured and then "my code works on my machine" becomes a team joke on day one at TCS or Infosys.

This guide walks you through installing the .NET 8 SDK, choosing between Visual Studio 2022 and VS Code, adding SQL Server Express and SSMS, and initializing Git — on Windows (primary), with notes for macOS and Linux. By the end you will run a verification app and be ready for Article 3 (project structure).

After this article you will

• Install .NET 8 SDK and confirm dotnet --version
• Configure Visual Studio 2022 Community or VS Code + C# Dev Kit
• Install SQL Server 2022 Express and connect with SSMS
• Initialize Git and make your first ShopNest commit
• Fix the most common installation errors seen in Indian dev labs

Prerequisites

• Hardware: 8 GB RAM minimum (16 GB recommended for Visual Studio + SQL Server)
• OS: Windows 10/11 (64-bit), macOS 12+, or Ubuntu 22.04+
• Previous lesson: What is ASP.NET Core? Complete Guide
• Time: 45–90 minutes (downloads depend on broadband speed)

What you are installing (and why)

Level 1 — Analogy

Building ASP.NET Core apps is like opening a cloud kitchen. The .NET SDK is your cooking equipment. Visual Studio / VS Code is the workstation. SQL Server is the pantry where ShopNest stores products and orders. Git is the CCTV log — every recipe change is recorded.

Level 2 — Technical stack

Level 3 — How it fits ShopNest

[Developer Machine]
  ├── .NET SDK 8.x          → dotnet CLI
  ├── Visual Studio / VS Code → edit ShopNest.Web + ShopNest.API
  ├── SQL Server Express    → ShopNestDb (local)
  ├── SSMS                  → inspect migrations
  └── Git repo              → github.com/you/shopnest

Step-by-step installation

1 — Install .NET 8 SDK (all platforms)

Download from dotnet.microsoft.com → SDK 8.0.x (not Runtime only).

Windows: Run the installer → accept defaults → restart terminal.

macOS: Download .pkg or use Homebrew: brew install dotnet@8

Linux (Ubuntu):

wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt update
sudo apt install -y dotnet-sdk-8.0

Verify:

dotnet --version
# Expected: 8.0.xxx

dotnet --list-sdks
# Should show 8.0.x

2 — Visual Studio 2022 Community (Windows — recommended for beginners)

1. Download Visual Studio 2022 Community
2. In the installer, select workload: ASP.NET and web development
3. Optional: .NET desktop development if you will explore WPF/WinForms later
4. Individual components: ensure .NET 8 SDK is checked
5. Install (8–15 GB) — on slow college lab PCs, start download before lunch

Screenshot described: Visual Studio Installer → Workloads tab → "ASP.NET and web development" card with green checkmark → Install button bottom-right.

First launch: sign in with Microsoft account (optional) → choose General or Visual C# color theme.

3 — VS Code + C# Dev Kit (Windows / Mac / Linux alternative)

1. Install VS Code
2. Extensions (Ctrl+Shift+X): install C# Dev Kit (Microsoft) — includes C# extension and solution explorer
3. Optional: REST Client, GitLens, Thunder Client for API testing

# Optional CLI install of extensions
code --install-extension ms-dotnettools.csdevkit
code --install-extension ms-dotnettools.csharp

VS Code is lighter (≈500 MB vs 10+ GB) — preferred on Mac/Linux and for developers who also work with Node/React on the same machine.

4 — SQL Server 2022 Express + SSMS (Windows)

1. Download SQL Server 2022 Express from Microsoft — choose Basic install for simplest path
2. Note your instance name: usually localhost\SQLEXPRESS or (localdb)\mssqllocaldb
3. Install SQL Server Management Studio (SSMS) separately
4. Open SSMS → Connect → Server name: localhost\SQLEXPRESS → Authentication: Windows Authentication

Connection string for later ShopNest appsettings.json:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost\\SQLEXPRESS;Database=ShopNestDb;Trusted_Connection=True;TrustServerCertificate=True;"
  }
}

macOS/Linux: Use SQL Server in Docker for EF lessons:

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=ShopNest@Dev123!" \
  -p 1433:1433 --name shopnest-sql -d mcr.microsoft.com/mssql/server:2022-latest

5 — Git setup and first commit

git --version
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

mkdir ShopNest
cd ShopNest
dotnet new sln -n ShopNest
dotnet new webapp -n ShopNest.Web
dotnet sln add ShopNest.Web/ShopNest.Web.csproj

git init
echo "bin/" >> .gitignore
echo "obj/" >> .gitignore
echo ".vs/" >> .gitignore
echo "appsettings.Development.json" >> .gitignore

git add .
git commit -m "chore: initial ShopNest solution (Article 2)"

Push to GitHub: create empty repo → git remote add origin … → git push -u origin main. Recruiters at Indian service companies often ask for GitHub links — start now.

6 — Verification checklist (run everything)

dotnet --version          # 8.0.x
dotnet new webapp -n EnvCheck -o EnvCheck
cd EnvCheck
dotnet run                # open https URL shown in console
dotnet test               # no tests yet — should pass with "no tests"
cd .. && rm -rf EnvCheck  # cleanup (Windows: rmdir /s EnvCheck)

In Visual Studio: File → New → Project → ASP.NET Core Web App (Razor Pages) → run with green ▶ button — browser should open.

Common installation errors & fixes

🔴 Error: 'dotnet' is not recognized
✅ Add C:\Program Files\dotnet\ to PATH; restart terminal; reinstall SDK.

🔴 Error: HTTP Error 500.30 - ANCM In-Process Start Failure
✅ Wrong .NET runtime installed; run dotnet --list-runtimes; install ASP.NET Core 8 hosting bundle on IIS machines.

🔴 Error: SQL — Cannot connect to localhost\SQLEXPRESS
✅ Start service "SQL Server (SQLEXPRESS)" in services.msc; enable TCP/IP in SQL Configuration Manager.

🔴 Error: Visual Studio — missing web template
✅ Re-run installer → Modify → check ASP.NET and web development workload.

🔴 Error: NU1100: Unable to resolve package
✅ Check internet/proxy; run dotnet nuget locals all --clear; restore again.

Best practices for your dev machine

• 🟢 Pin SDK version in global.json when joining a team project
• 🟢 Use User Secrets for local connection strings — never commit passwords
• 🟡 Keep VS and SDK updated quarterly — .NET 8 is LTS until November 2026
• 🟡 Allocate 20 GB free disk before installing VS + SQL together
• 🔴 On corporate laptops (TCS/Infosys image), request admin rights or use VS Code + Docker SQL

Interview questions

Fresher

Q1: Difference between SDK and runtime?
A: SDK builds and runs apps; runtime only runs published apps.

Q2: What is SSMS used for?
A: GUI tool to connect to SQL Server, run queries, design tables, view data.

Q3: Why Git in a solo learning project?
A: Tracks history, enables portfolio on GitHub, mirrors team workflow in industry.

Q4: Can ASP.NET Core run on Linux?
A: Yes — Kestrel is cross-platform; many Azure Linux App Service apps use it.

Q5: What is LocalDB?
A: Lightweight SQL Server Express instance for development, started on demand.

Q6: Minimum install to run dotnet new webapp?
A: .NET SDK with ASP.NET Core templates (included in web workload or SDK).

Junior / mid

Q7: VS Code vs Visual Studio for ASP.NET Core?
A: VS = richer debugging, designers, profiling; VS Code = lighter, cross-platform, great with Dev Kit for APIs and microservices.

Q8: How do you manage secrets locally?
A: dotnet user-secrets in Development; Azure Key Vault or env vars in Production.

Senior

Q11: Standardizing dev environments across 50 developers?
A: Docker Compose for SQL/Redis, global.json, documented VS workloads, optional dev containers / GitHub Codespaces.

Coding round

Problem: Write a bash/PowerShell one-liner concept: verify SDK installed and print version (they may ask in ops-style screens).

dotnet --version || echo "Install .NET SDK from https://dotnet.microsoft.com"

Summary

• Install .NET 8 SDK and verify with dotnet --version
• Choose VS 2022 (Windows, full IDE) or VS Code + C# Dev Kit (all platforms)
• Add SQL Server Express + SSMS (or Docker SQL on Mac/Linux)
• Initialize Git and commit your ShopNest solution skeleton
• Run the verification webapp before moving on

Previous: What is ASP.NET Core?
Next: ASP.NET Core Project Structure Explained

FAQ