2025-12-01 22:30:18 +01:00
2025-12-01 22:28:20 +01:00
2025-08-02 16:33:47 +02:00
2024-11-10 18:56:52 +01:00
2024-11-08 17:30:06 +01:00
2025-10-26 19:22:21 +01:00

cws

A minimal web server. This is a personal project; it is not intended to be a production-ready tool, nor will it ever be. Use it at your own risk.

Requirements

  • meson
  • libcyaml
  • myclib (on my profile)
  • doxygen
    • Optional, just to build the docs. It requires dot.

How to build

$ meson setup build
$ cd build
$ meson compile

And then run cws!

Docs

$ git submodule update --init
$ doxygen

And then open the docs/html/index.html.

Roadmap

  • HTTPS support with TLS
  • Support for virtual hosts
  • CLI args

Future

  • Minimal Templating
  • Logging to file
  • Reverse proxy
  • IPv6 compatible
  • Compression (Gzip)

Performance

This test was performed using wrk.

wrk command
$ wrk -t12 -c400 -d30s http://127.0.0.1:3030/index.html
Running 30s test @ http://localhost:3030
  12 threads and 400 connections
  Thread Stats   Avg      Stdev     Max   +/- Stdev
    Latency     3.45ms    2.37ms  91.92ms   95.45%
    Req/Sec    10.08k     1.33k   19.57k    82.30%
  3621422 requests in 32.47s, 2.55GB read
  Socket errors: connect 0, read 0, write 0, timeout 395
Requests/sec: 111514.25
Transfer/sec:     80.51MB
Description
A minimal Web Server (gh mirror)
Readme GPL-3.0 572 KiB
Languages
C 71.6%
HTML 26.5%
Meson 1.9%