Documentation hub — node-http-server

Task map

Open one focused page.

Start

Install, first listener, module choices, defaults, and project status.

Overview → Why node-http-server

Decision signals, project fit, interfaces, boundaries, and evidence.

Decision guide → CLI

Every flag, task recipe, syntax rule, output, exit, and failure.

Command guide → Library API

Node.js CommonJS/ESM, instances, lifecycle, methods, requests, and hooks.

API reference → Configuration

Every key/default, opt-out semantics, MIME, errors, logs, and HTTPS.

Config reference → HTTPS

Native TLS, HTTPS-only and paired modes, listener lifecycle, certificates, and failures.

HTTPS guide → Examples

Copyable CLI and library patterns with expected results and failures.

Examples → Playground

Generate CommonJS, Node.js ESM, CLI, and serializable JSON configuration.

Generator → Testing & coverage

Four focused suites, per-file gates, reports, badges, CI, and contributor steps.

Testing guide → Performance

9.0.2 comparison, raw alternating samples, workload contracts, and reproduction.

Performance report → Benchmarks

Real loopback requests, public-path scenarios, options, metrics, and comparison discipline.

Benchmark guide → Operations

Exposure, HTTP failures, shutdown, logs, certificates, and migration to v10.

Operations →

Quick lookup

Question	Go here
How do I use a free local port?	CLI common tasks
What does false or 0 disable?	Limits and timeouts
How do CJS and ESM exports differ?	Library imports
How do I run multiple servers?	Multiple servers and shutdown
How do I serve an SPA?	SPA + compression example
How do I run HTTPS-only or HTTP + HTTPS?	HTTPS transport modes
How do MIME overrides and denials work?	MIME and restrictions
Why did a request return 403/413/415/416/421?	Failure map
Where are tests and coverage reports?	Testing reports and badges
What changed on measured core hot paths?	9.0.2 comparison results
How do I measure real server paths?	Benchmark commands and profiles
How do I upgrade from v9 to v10?	HTTP/2 migration checklist
What changed from v8 to v9?	Earlier migration checklist

Repository documents

Package overview and complete reference in the npm artifact.

v9-to-v10 HTTP/2 compatibility and earlier v8-to-v9 upgrade guidance.

Supported releases, exposure boundary, certificates, hooks, and MIME.

Versioned changes, including HTTP/2 in 10.0.0.