Skip to main content

C# Basic Webserver

C# Basic Webserver logo
C# Basic Webserverv1.0.0

ASP.NET Core server with health endpoint and Docker support

Tools: dev-csharp
Install:dev-template csharp-basic-webserver
Website ↗Docs ↗
csharpdotnetaspnetwebserverapirest

Summary​

A minimal ASP.NET Core web server with hot reload via dotnet watch, Docker multi-stage build, Kubernetes deployment manifests, and GitHub Actions CI/CD workflow.

A minimal ASP.NET Core web server. Displays "Hello World" with current time and date, with hot reload support via dotnet watch.

Quick Start​

  1. Update your terminal (tools were installed):

    source ~/.bashrc

  2. Run the app:

    dotnet watch run --project src/WebApplication

  3. Open in browser: http://localhost:3000

The server auto-reloads on file changes via dotnet watch.

Prerequisites​

Development tools are installed automatically by the devcontainer. If you need to reinstall, run: dev-setup

Project Structure​

After installation, your project contains:

├── src/
│   └── WebApplication/
│       ├── Program.cs                     # ASP.NET Core entry point
│       └── WebApplication.csproj          # Project dependencies
├── manifests/
│   ├── deployment.yaml                    # K8s Deployment + Service
│   └── kustomization.yaml                 # ArgoCD configuration
├── .github/
│   └── workflows/
│       └── build-and-push.yaml            # CI/CD pipeline
├── Dockerfile                             # .NET multi-stage build
├── TEMPLATE_INFO                          # Template metadata
└── README-csharp-basic-webserver.md       # This file

Development​

  • Edit src/WebApplication/Program.cs — the main application file
  • Changes auto-reload via dotnet watch
  • The / endpoint returns "Hello World" with the template name and current time/date

Docker Build​

docker build -t csharp-basic-webserver .
docker run -p 3000:3000 csharp-basic-webserver

Kubernetes Deployment​

kubectl apply -k manifests/

The app will be accessible at http://<app-name>.localhost after ArgoCD registration.

CI/CD​

The GitHub Actions workflow automatically builds and pushes the Docker image to GitHub Container Registry when changes are pushed to the main branch.