A lightweight debugging and diagnostic tool that exposes server environment information and client request details for .NET applications. This tool helps developers and IT administrators understand their application's runtime environment and incoming HTTP requests.

Server Info is a web-based diagnostic tool built with ASP.NET Core that provides:

• Server Environment Information: View environment variables, system details, and runtime configuration
• Client Request Analysis: Inspect HTTP headers, client IP addresses, and request metadata
• Container-Friendly: Optimized for containerized environments and cloud deployments
• Real-time Data: Live information about the current server state and incoming requests

For Developers:

• Debug environment-specific issues in different deployment contexts
• Understand what environment variables and configuration are available
• Analyze HTTP request flow and headers during development

For IT Administrators:

• Quickly inspect server environment details in container environments
• Troubleshoot network configuration and proxy settings
• Verify environment variable propagation in deployments

For DevOps Teams:

• Validate container deployment configurations
• Debug load balancer and reverse proxy configurations
• Monitor request routing and header manipulation

• Environment Information Display

  • System environment variables
  • Application configuration
  • Runtime information (.NET version, OS details)
  • Performance counters and system metrics

• Client Request Analysis

  • HTTP headers inspection
  • Client IP address detection (supports X-Forwarded-For)
  • Request metadata and routing information
  • Browser and user agent details

• Container-Ready

  • Docker support with included Dockerfile
  • Lightweight and optimized for containerized deployments
  • Cloud platform compatibility (Azure, AWS, etc.)

To run Server Info locally, ensure you have the following installed:

• .NET 9.0 SDK or later
• Git
• Optional for development:
  • Visual Studio Code with C# Dev Kit
  • Visual Studio 2022 (17.8 or later)
• Optional for deployment:
  • Docker for containerized deployment
  • Azure Developer CLI (azd) for Azure deployment

1. Clone the repository:

   git clone https://github.com/microsoft/Server-Info.git cd Server-Info

2. Navigate to the project directory:

   cd Server-Info/Server-Info

3. Run the application:

   dotnet run

4. Access the application:

   • Open your browser and navigate to https://localhost:7028 (or the URL displayed in the terminal)
   • The application will display server and environment information

1. Build the Docker image:

   docker build -t server-info .

2. Run the container:

   docker run -p 8080:8080 server-info

3. Access the application:

   • Navigate to http://localhost:8080

The main dashboard provides a comprehensive view of your server environment in an organized, easy-to-read format.

Features displayed:

• Environment variables and their values
• System information (OS, .NET version, etc.)
• Application configuration settings
• Performance metrics and runtime details

The Client tab reveals detailed information about incoming HTTP requests and client characteristics.

Information includes:

• Browser and user agent details
• Client IP address (with proxy detection)
• Referrer and request metadata
• Session and authentication information

Scroll down on the Client page to view comprehensive HTTP header information from the current request.

Header details:

• All HTTP request headers
• Custom headers and their values
• Forwarded headers (X-Forwarded-For, X-Real-IP, etc.)
• Security and caching headers

The application automatically detects and displays environment variables. You can control visibility by setting:

• Never deploy in production with public access
• Restrict network access to authorized users only
• Use in internal/development environments only
• Monitor access logs if deployed in shared environments
• Consider authentication for sensitive environments

✅ Safe Usage:

• Local development environments
• Internal corporate networks with restricted access
• Development and staging environments
• Containerized environments with network isolation
• Behind VPN or corporate firewall

❌ Avoid:

• Public internet deployment
• Production environments
• Unsecured network access
• Environments with sensitive customer data

Application won't start:

• Verify .NET 9.0 is installed: dotnet --version
• Check port availability (default: 7028 for HTTPS, 5000 for HTTP)
• Review application logs for startup errors

Docker container issues:

• Ensure Docker is running: docker version
• Check port mapping: -p 8080:8080
• Verify image build: docker images

Missing environment variables:

• Variables may be filtered for security
• Check container environment variable injection
• Verify environment-specific configuration files

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.