Localhost dev server

Your own little fake internet

I am building some HTML page. I can do some things with an HTML files on my hard disk, although these are locked down for security reasons. So I run a local server to serve those files and have my browser treat them like part of the real internet.

Usually for local testing, serving the files unencrypted (plain HTTP) is enough; sometimes for weird edge-case reaons I need to do encrypted (keywords: HTTPS/SSL/TLS) which is a whole ’nother thing.


There is a sport of writing HTTP server one-liners, and a mini site for them.

Here are some strategic ones that are likely to work with no further fuss.


Bareback feature-free somehow-works HTTP with netcat:

nc -l 8889 < foo.html


This is reasonably simple and serves static files with little fuss.

python3 -m http.server --bind

VS Code

Live Preview runs a sophistacted integrated server inside VS code.


Caddy, is a free and open source server, and that will get you a long way. It has automatic SSL. It has plugins supporting totally OTT features such as AWS lambda function proxying and automatic hugo for plain text blogging.

caddy file-server --listen

npm servers

For node browser apps, e.g. beefy and run-browser and their ilk might work and probably integrate with your build process. There are so many different options for node that I usually pass over it in choice-paralyzed silence.

Fenix is a GUI wrapped around a node-style server that promises advanced debugging/introspection features. But I haven’t used it and it doesn’t run on Linux, so ignoring for now.


As mentioned at R HTML slides I use this CLI script, which is has a couple of useful features such as auto-watching for file changes.

#!/usr/bin/env Rscript
cmdArgs = commandArgs(trailingOnly = TRUE)
if (length(cmdArgs>0)){
    port = strtoi(cmdArgs[1])
browseURL(paste("", port, sep="")

I save it in serve.R and execute it as

serve.R 4000

Oh wait but I need encryption

Crap. I understand, but this is tricky in general. Perhaps you don’t truly need SSL? Most SSL-secured things are also available without SSL on localhost domain. Failing that, Caddy is probably easiest. See bonus tips under secure servers.

Bonus time: tunneling

ngrok is a service that allows you to inspect and replay web service requests from the internet to a local server for analysis.

No comments yet. Why not leave one?

GitHub-flavored Markdown & a sane subset of HTML is supported.