LocalDevelopment

Local Development Setup

This guide explains how to set up CloudDebugger for local development.

Prerequisites

Before starting, ensure you have the required tools installed. See Prerequisites for the full list.

Clone the Repository

git clone https://github.com/tndata/CloudDebugger.git
cd CloudDebugger

Building the Application

Using Command Line

# Build the solution
dotnet build CloudDebugger.sln

# Build for release
dotnet build CloudDebugger.sln -c Release

Using Visual Studio

1. Open CloudDebugger.sln in Visual Studio
2. Build the solution (Ctrl+Shift+B)

Running Locally

Using Command Line

dotnet run --project CloudDebugger/CloudDebugger.csproj

The application will start and display the URLs it's listening on (typically https://localhost:5001).

Using Visual Studio

1. Set CloudDebugger as the startup project
2. Press F5 to run with debugging, or Ctrl+F5 to run without debugging

Using Docker

# Build the Docker image
docker build -t clouddebugger .

# Run the container
docker run -p 8080:8080 clouddebugger

Then open http://localhost:8080 in your browser.

Features Available Locally

Many CloudDebugger features work without any Azure configuration:

• Current Request viewer
• Request Logger
• Environment Variables viewer
• File System browser
• Health endpoints
• OpenTelemetry tools
• Load Testing tools

Troubleshooting

Port Already in Use

If you get a port conflict error, specify a different port:

dotnet run --project CloudDebugger/CloudDebugger.csproj --urls "https://localhost:5002"

SSL Certificate Issues

For development, trust the .NET development certificate:

dotnet dev-certs https --trust

Build Errors

1. Ensure you have .NET 10 SDK installed: dotnet --version
2. Try cleaning and rebuilding: dotnet clean && dotnet build

See Also

• Prerequisites - System requirements
• Deployment - Deploying to Azure