https://github.com/eastcitysoftware/sergio

A static web server built on Kestrel
https://github.com/eastcitysoftware/sergio

fsharp kestrel static-file-server

Last synced: 10 months ago
JSON representation

A static web server built on Kestrel

• Host: GitHub
• URL: https://github.com/eastcitysoftware/sergio
• Owner: eastcitysoftware
• License: mit
• Created: 2020-05-08T13:17:29.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2025-08-20T01:16:56.000Z (10 months ago)
• Last Synced: 2025-08-20T02:39:14.876Z (10 months ago)
• Topics: fsharp, kestrel, static-file-server
• Language: C#
• Homepage:
• Size: 33.2 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


![sergio](https://github.com/eastcitysoftware/sergio/blob/assets/sergio.png?raw=true)

[![build](https://github.com/eastcitysoftware/sergio/actions/workflows/build.yml/badge.svg)](https://github.com/eastcitysoftware/sergio/actions/workflows/build.yml)

![License](https://img.shields.io/github/license/eastcitysoftware/sergio)

Static web server with hot reload.



---

Meet Sergio, the no-frills static web server that’s here to make your life easier. Need to spin up a local server faster than you can say "localhost"? Sergio’s got you covered. No bloated configs, no unnecessary drama—just pure, unadulterated serving power. Whether you’re testing, debugging, or showing off your latest masterpiece, Sergio serves it hot and fresh every time.

Because life's too short for 404s.

---

## Usage

```shell

Usage of .\sergio.exe:

Description:

  sergio, static web server with hot reload

Usage:

  sergio  [options]

Arguments:

    The absolute path to a website directory or sergio.json file

Options:

  -?, -h, --help            Show help and usage information

  --version                 Show version information

  port, -p                  The port to listen on [default: 8080]

  disable-compression, -ec  Disable response compression

  verbose                   Enable verbose logging

```

## Examples

### Run a single website

```shell

sergio C:\path\to\website

```

Or, to configure:

```shell

sergio C:\path\to\website --port 3000 --disable-compression --verbose

```

### Run multiple websites

> Changes to the `sergio.json` file will automatically trigger a reload of the server.

```shell

sergio C:\path\to\sergio.json

```

Or, to configure:

```shell

sergio C:\path\to\sergio.json --port 3000 --disable-compression --verbose

```

### Example `sergio.json`

```json

[

    {

      "domain": "site1.local",

      "root": "C:\\path\\to\\website1",

      "cacheExpirationSeconds": 3600

    },

    {

      "domain": "site2.local",

      "root": "C:\\path\\to\\website2",

      "cacheExpirationSeconds": 60

    }

]

```