Create a gist now

Instantly share code, notes, and snippets.

What would you like to do?
Big list of http static server one-liners

Each of these commands will run an ad hoc http static server in your current (or specified) directory, available at http://localhost:8000. Use this power wisely.

Discussion on reddit.

Python 2.x

$ python -m SimpleHTTPServer 8000

Python 3.x

$ python -m http.server 8000

Twisted (Python)

$ twistd -n web -p 8000 --path .


$ python -c 'from twisted.web.server import Site; from twisted.web.static import File; from twisted.internet import reactor; reactor.listenTCP(8000, Site(File(".")));'

Depends on Twisted.


$ ruby -rwebrick -e' => 8000, :DocumentRoot => Dir.pwd).start'

Credit: Barking Iguana

Ruby 1.9.2+

$ ruby -run -ehttpd . -p8000

Credit: nobu

adsf (Ruby)

$ gem install adsf   # install dependency
$ adsf -p 8000

Credit: twome

No directory listings.

Sinatra (Ruby)

$ gem install sinatra   # install dependency
$ ruby -rsinatra -e'set :public_folder, "."; set :port, 8000'

No directory listings.


$ cpan HTTP::Server::Brick   # install dependency
$ perl -MHTTP::Server::Brick -e '$s=HTTP::Server::Brick->new(port=>8000); $s->mount("/"=>{path=>"."}); $s->start'

Credit: Anonymous Monk

Plack (Perl)

$ cpan Plack   # install dependency
$ plackup -MPlack::App::Directory -e 'Plack::App::Directory->new(root=>".");' -p 8000

Credit: miyagawa

Mojolicious (Perl)

$ cpan Mojolicious::Lite   # install dependency
$ perl -MMojolicious::Lite -MCwd -e 'app->static->paths->[0]=getcwd; app->start' daemon -l http://*:8000

No directory listings.

http-server (Node.js)

$ npm install -g http-server   # install dependency
$ http-server -p 8000

Note: This server does funky things with relative paths. For example, if you have a file /tests/index.html, it will load index.html if you go to /test, but will treat relative paths as if they were coming from /.

node-static (Node.js)

$ npm install -g node-static   # install dependency
$ static -p 8000

No directory listings.

PHP (>= 5.4)

$ php -S

Credit: /u/prawnsalad and MattLicense

No directory listings.


$ erl -s inets -eval 'inets:start(httpd,[{server_name,"NAME"},{document_root, "."},{server_root, "."},{port, 8000},{mime_types,[{"html","text/html"},{"htm","text/html"},{"js","text/javascript"},{"css","text/css"},{"gif","image/gif"},{"jpg","image/jpeg"},{"jpeg","image/jpeg"},{"png","image/png"}]}]).'

Credit: nivertech (with the addition of some basic mime types)

No directory listings.

busybox httpd

$ busybox httpd -f -p 8000

Credit: lvm


$ webfsd -F -p 8000

Depends on webfs.

IIS Express

C:\> "C:\Program Files (x86)\IIS Express\iisexpress.exe" /path:C:\MyWeb /port:8000

Depends on IIS Express.

Credit: /u/fjantomen

No directory listings. /path must be an absolute path.


If you have any suggestions, drop them in the comments below or on the reddit discussion. To get on this list, a solution must:

  1. serve static files using your current directory (or a specified directory) as the server root,
  2. be able to be run with a single, one line command (dependencies are fine if they're a one-time thing),
  3. serve basic file types (html, css, js, images) with proper mime types,
  4. require no configuration (from files or otherwise) beyond the command itself (no framework-specific servers, etc)
  5. must run, or have a mode where it can run, in the foreground (i.e. no daemons)

For PHP >=5.4 you can run

$ php -S localhost:8000


erl -s inets -eval 'inets:start(httpd,[{server_name,"NAME"},{document_root, "."},{server_root, "."},{port, 8000}]).'

aschmoe commented Jun 6, 2013

If you ever use Drupal, drush 5+ has

$ drush rs 8080

twome commented Jun 6, 2013

Another Ruby:

$ gem install adsf
$ adsf

willurd commented Jun 6, 2013

Thanks for the suggestions everyone!

lvm commented Jun 7, 2013

busybox edition:

busybox httpd -p $PORT -h $HOME [ -c httpd.conf ]

Note that the config file is not required but optional.


willurd commented Jun 7, 2013

@lvm Thanks. That violates requirement #4 though (because it needs an httpd.conf file).

lvm commented Jun 10, 2013

Oh well, let me rephrase it then :)


willurd commented Jun 12, 2013

@lvm Added, thanks!

Peeja commented Jul 3, 2013

This is awesome! One note though, re: http-server:

Note: This server does funky things with relative paths. For example, if you have a file /tests/index.html, it will load index.html if you go to /test, but will treat relative paths as if they were coming from /.

That should be true for any of these. That's just how HTTP/HTML works. If you go to /test/ (note the trailing slash), then relative URLs will be relative to /test/. Relative URLs are always relative to the last slash in the URL.

The server can't control that; resolving relative URLs is the browser's job, and the browser doesn't know that /test is meant to be a directory. What some servers will do for you is redirect to the trailing-slash URL automatically, which other servers listed here may do—I'm not sure.

nobu commented Jul 3, 2013

Ruby 1.9.2+:

$ ruby -run -ehttpd . -p8000

willurd commented Jul 7, 2013

@nobu Added, thanks!


willurd commented Jul 7, 2013

@Peeja Automatic redirection is probably what's happening. Thanks!

Just in case you can't install with -g flag in Node.js and node is all you got, try
npm install connect && echo "var c = require('connect');c.createServer(c.static(__dirname)).listen(8080);" | node
Note: may get you really weird results + might pollute your folder with node_modules

sshtyck commented Dec 13, 2013


$ perl -MIO::All -e 'io(":8080")->fork->accept->(sub { $_[0] < io(-x $1 +? "./$1 |" : $1) if /^GET \/(.*) / })'

Thanks to:

Created a shell function for this "I only needed Python, Ruby & PHP", maybe someone will find this useful.

I just created srvdir which solves this problem elegantly. It is open source on github and available as a simple binary download with no dependencies for all major operating systems:

srvdir homepage
srvdir code on github

Unlike all of the other solutions, srvdir serves your directory on a public HTTPS URL with an optional password. This means you can securely share the URL with anyone on the internet and are not restricted to just your local network.

It's also ridiculously simple to use. Serve files in the current directory:


Serve files from multiple named directories simultaneously:

./srvdir /usr/lib /var/www/

gem install knod to install dependency
knod -p 8000

Warning! Knod can also write to and delete from the directory you specify.

gdiggs commented Apr 16, 2014

Wrote a go version. It's complicated by the fact that you can't interpret go code from the command line without a file (like you can with ruby) so it makes a file that deletes itself upon exiting.

sesm commented Apr 29, 2014

Clojure (via Leiningen project management tool):

$ lein simpleton 8080

Note: you should install lein-simpleton plugin first by putting [lein-simpleton "1.3.0"] into the :plugins vector of your :user profile. Profiles are configured in ~/.lein/profiles.clj, if you don't have this file yet, you can start with

$ echo "{:user {:plugins [[lein-simpleton \"1.3.0\"]]}}" > ~/.lein/profiles.clj

fahrinh commented May 2, 2014

Spark (Go)

$ go get
$ spark -port 8000 .


$Hso=New-Object Net.HttpListener;$Hso.Prefixes.Add("http://+:8000/");$Hso.Start();While ($Hso.IsListening){$HC=$Hso.GetContext();$HRes=$HC.Response;$HRes.Headers.Add("Content-Type","text/plain");$Buf=[Text.Encoding]::UTF8.GetBytes((GC (Join-Path $Pwd ($HC.Request).RawUrl)));$HRes.ContentLength64=$Buf.Length;$HRes.OutputStream.Write($Buf,0,$Buf.Length);$HRes.Close()};$Hso.Stop()

PowerShell from cmd.exe


karuna commented Jun 12, 2014

Is there any that show directory listing instead of loading index.html?

somlor commented Jun 22, 2014

$ gem install serve
$ serve

mauvm commented Jun 22, 2014

$ npm install -g beefy
$ beefy

With build in support for browserify, watchify, and live-reload.

Paxa commented Jun 22, 2014

Also for ruby

$ gem install httpit
$ httpit

kidoman commented Jun 22, 2014

brew install kidoman/tools/serve


go get

Provided you have serve under your $PATH somewhere:

serve .

This will serve the current directory at http://localhost:5000/

serve -p 9999 ~/my-awesome-blog

Will serve the contents of the folder ~/my-awesome-blog at http://localhost:9999/

serve -x /my ~/precious

You guessed it, http://localhost:5000/my is now wired up to ~/precious

serve -o ~/sesame

Wires up http://localhost:5000 to ~/sesame and opens the URL in your favorite browser while it is at it.

shameless plug for node: glance
has index file support, directory listing, error pages, etc etc.

npm install -g glance

speier commented Jun 22, 2014

Harp, static web server with built-in preprocessing.

$ npm install -g harp
$ harp server

Val commented Jun 22, 2014

Rack (ruby)

gem install rack --no-ri --no-rdoc
rackup -b 'use Rack::Static, :index => 'README.html'; run'.')"

mbleigh commented Jun 22, 2014

Superstatic, static web server with support for pushState, cache control, and more.

npm install -g superstatic
superstatic -p 8000

I'd like to request a bash http server using /dev/tcp, anybody has a one-liner for that?

amitu commented Jun 23, 2014

$ pip install djangothis
$ djangothis

Assumes html files in current folder are django templates, so inheritance etc work. Also files in static folder are served as static files with correct mime types. named file can contain importd/django views in case you want to grow.

avsm commented Jun 23, 2014

OCaml is

opam install cohttp async


opam install cohttp lwt ssl


For python with live reload feature..

pip install livereload
livereload                         #serves current dir with port 35729 which livereload extensions use
livereload ~/testing -p 8000       # to serve specific directory from specific port

And you can setup shell commands and such for livereloading..

ibaaj commented Aug 19, 2014

Create an alias in your .bashrc

function serve {
  http-server . -p $port

Then just run

serve 5000


$ npm install startserver -g
$ server 8080

mufid commented Oct 6, 2014

This is very handy to stream media in my notebook to my phone. Awesome! Thanks!

Very coool gist!! Made my day B-)

oboxodo commented Jan 15, 2015

Add serve

$ gem install serve
$ cd my-project
my-project$ serve

you can also start HTTPS server which may be important for WSS services, example with Mojo:
perl -Mojo -MCwd -E'app->static->paths->[0]=getcwd; app->start' daemon -l 'https://*:8000' (note the http_s_)

eadz commented May 24, 2015

For any of these, it would be worth making an alias in your shell.

For example for the ruby example and zsh.

alias server="ruby -run -ehttpd . -p 8080"

in your .zshrc means you can just run "server"


perl -MHTTP::Daemon -e '$d = HTTP::Daemon->new(LocalPort => 8000) or  +die $!; while 
($c = $d->accept) { while ($r = $c->get_request) { +$c->send_file_response(".".$r->url->path) } }'

HTTP::Daemon comes preinstalled on many Linux distribution and thus works out of the box.

Credit goes to Anonymous Monk

mayrund commented Jul 28, 2015

Thank you!

Yet another. This is basically SimpleHTTPServer with serving folder and IP parameters. Plus the hability to remove the serving folder and later recreate it.


pip install webdev


$ webdev --help
usage: webdev [-h] [-v] [--version] [-i IP] [-p PORT] [path]

Development Web Server

positional arguments:
  path                  Path to serve. Default: Current directory.

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         Increase verbosity level
  --version             show program's version number and exit
  -i IP, --ip IP        IP to bind to. Default:
  -p PORT, --port PORT  Port to listen to. Default: 8080.

beno commented Sep 7, 2015


Here's one for Crystal. Speedy!

crystal eval 'require "http/server"; h ="."); {|r| }.listen'


crystal eval 'require "http/server";,".")).listen'

Are there ANY which are available on a default Windows installation?

Sebb767 commented Nov 10, 2015

The powershell one should be.

hanksudo commented Dec 2, 2015

anyway to simply add allow CROS header in one line?

There are a couple problems I fixed in the powershell oneliner:

  • Running without elevation, binding to http://+:8000/ fails with "Access is denied". Binding to http://localhost:8000/ instead.
  • Serving HTML as plain text content type means it won't render in the browser. Lookup content type mapping.
  • The GC was removing newlines from the file, which is awkward if you have javascript using // comments. Just open a Stream.
    • bonus: streams instead of buffers!
Add-Type -AssemblyName "System.Web";$Hso=New-Object Net.HttpListener;$Hso.Prefixes.Add("http://localhost:8000/");$Hso.Start();While ($Hso.IsListening){$HC=$Hso.GetContext();$HRes=$HC.Response;$HRes.Headers.Add("Content-Type",[System.Web.MimeMapping]::GetMimeMapping($HC.Request.RawUrl));$Stream=[System.IO.File]::OpenRead((Join-Path $Pwd ($HC.Request.RawUrl)));$HRes.ContentLength64=$Stream.Length;$Stream.CopyTo($HRes.OutputStream);$Stream.Close();$HRes.Close()};$Hso.Stop()

I also can't figure out how to break out of the one-liner from the command line. Ctrl-C and Ctrl-Break don't do anything. Having to kill powershell.exe is annoying.

cameronkerrnz commented Jan 15, 2016

And in case you're wondering where HTTPS is in all this...

Turns out to pretty simple with OpenSSL's s_server utility. I've just used this to help test out a load-balancer configuration before the real backend was ready (not to serve content per-se). The first line creates a self-signed certificate.

openssl req -newkey rsa:2048 -nodes -x509 -subj '/' -days 3650 -out server.cert -keyout server.key
openssl s_server -accept 7781 -cert server.cert -key server.key -WWW

Unfortunately, this does not work for HEAD requests, which is a shame, because the behaviour is to time out.

See the manual page for s_server for more info.

FYI some time ago I tweaked my (perl) HTTP::Server::Brick module to make one liners easier.

perl -MHTTP::Server::Brick -e 'HTTP::Server::Brick->new(fork=>1)->mount(qw(/ .))->start'

It can also support SSL, see

vwochnik commented Mar 5, 2016

For Go, there is a simple HTTP server at

go install vwochnik/gost

Then, simply run


no pul requests with gist, made a syntactic sugar fix to php

qwIvan commented Apr 23, 2016

npm install anywhere -g


withakay commented May 1, 2016

Haskell (via the maid module

cabal install maid

serve cwd on default port 3000

serve on another port
maid 5000

  1. Do any of these support ipv6?
  2. Can I change the 404 page for any of them?

One more for Ruby using Rack.

ruby -r rack -e "Rack::Server.start && run('./public'))"

For Laravel (PHP):

php artisan serve


php artisan serve --host= --port=8000

hickford commented Aug 2, 2016

I like "Ran: a simple static web server written in Go"

ran -p 8000

ebraminio commented Aug 12, 2016

Mine, zero install if node.js available:, source
curl | node
Additionatlly, it supports [cross-domain] browser console/terminal/browser drag&drop uploads and regular and multipart (HTTP 206) downloads

yaasita commented Sep 6, 2016

docker run -d -p 8080:80 --name my-apache-app -v "$PWD":/usr/local/apache2/htdocs/ httpd:2.4-alpine

Can use netcat on *nix machines:

while true ; do nc -l 80 < test.html ; done

souenzzo commented Oct 2, 2016

darkhttpd . (deps: darkhttp)

gbc921 commented Nov 9, 2016

How about nweb (previously from IBM)?
Example: nweb 8181 /home/nwebdir &

MW3000 commented Nov 11, 2016

Pharo Smalltalk:

(ZnServer startDefaultOn: 8000) delegate: (ZnStaticFileServerDelegate new directory: '/var/www' asFileReference; yourself).

mohanraj-r commented Nov 24, 2016

Following is the same implementation in golang. Although technically it is not a one-liner and requires you to type out the contents in a file ..etc, I have seen it perform 10x faster (req/sec) than the Python 2.7.10 / 3.5 equivalents (measured using apachebench ab -n 1000 ..).


import "net/http"

func main() {
   http.ListenAndServe(":8000", http.FileServer(http.Dir(".")))

> go run main.go

olejorgenb commented Dec 26, 2016

Python 3: Restrict access to connections from localhost: python -m http.server 8000 --bind [1]

mholt commented Jan 3, 2017

Caddy does all of this and without any dependencies (plus it runs anywhere):

$ caddy -port 8000

cheater commented Jan 3, 2017

@GordonDiggs you can use <(echo ...) in bash to simulate files. Maybe that could hrlp with Go.

Rust has http:

$ cargo install https
$ http
Hosting "." on port 8000...
Ctrl-C to stop.

Following up on the Go example by @mohanraj-r, you can also install gommand and run

gommand 'http.ListenAndServe(":8000", http.FileServer(http.Dir(".")))'

directly from the command line without creating an intermediate source file.

Here's how you'd do something like that in CHICKEN:

chicken-install -s spiffy
csi -R spiffy -e '(root-path ".") (start-server port: 8008)'

Note that does no directory listing, so you have to include the filenames in your url. Directory listings make things uglier:

chicken-install -s spiffy-directory-listing
csi -R spiffy-directory-listing -R spiffy -e '(handle-directory spiffy-directory-listing) (root-path ".") (start-server port: 8008)'

Similar to ibaaj, I have the following function in my bash setup:

function serve() {
	if [ $# -eq 0 ]; then
		php -S localhost:8000
		php -S localhost:"$@"

If you run serve, it starts the server on port 8000. If you supply an argument, it expects that argument to be the port number, and uses that instead.

jeremejazz commented Feb 27, 2017

@matrunchyk I don't think that's for running static html files. That is used to run a laravel framework. Although you might see your static files, you are still required to install Laravel framework. Just use the built-in php server to run simple webpages (as aready included on the list)

$ go get
$ $GOPATH/bin/gotty -a -p 8000 -w cat file.ext

Grinnz commented Mar 29, 2017

For a pre-built Mojolicious (perl) solution with directory listings:

$ cpan App::SimpleHTTPServer
$ serve_dir

(defaults to port 8000)

3rdp commented Apr 16, 2017

$ npm install -g serve
$ serve .

(this will host . at localhost:5000)

yihui commented Apr 29, 2017


Using the servr package:

$ Rscript -e 'servr::httd()' -p8000

Sometimes I want to check the gzipped size when comparing solutions. Here's how you can do it with a one liner in Ruby assuming the rack gem is installed:

rackup -p 5000 < <(echo "use Rack::Deflate; use Rack::Static, root: Dir.pwd, urls: [''], index: 'index.html'; run ->(env){[404, {}, []]}")

I recently used ngrok to help me serve files.
You can download to install on Windows or brew cask install ngrok on Mac.
To run in this example use ngrok http 8000.

lyman commented Jun 16, 2017

For twistd 17.1.0,port format should be twistd -n web -p 'tcp:port=8081' --path .

If you have npm version 5.2 or newer, you can one-liner it with npx node-static -p 8000

hansnans commented Aug 1, 2017

(python) static localhost 8080 path

qwIvan commented Aug 13, 2017

npm install -g anywhere
npx anywhere

konfou commented Aug 14, 2017

On darkhttpd referred before, it can be quickly downloaded, built and run by doing:

curl -L | cc -O2 -o darkhttpd -xc -
darkhttpd . --port 8000

Similarly for, the also referred before, nweb:

curl -L | cc -O2 -o nweb -xc -
nweb 8000 . &

And yet another one is tiny:

curl -L | cc -O2 -o tiny -xc -
tiny 8000

Nakilon commented Sep 16, 2017

These versions of adsf gem are currently available: (1.2.1, 1.2.0, 1.1.1, 1.0.1, 1.0)
All above the 1.0 require Ruby >=2.2.2 because of Rack.

So Ruby 2.0 can run only asdf 1.0 or do a gem install rack --version 1.6.0 before installing the latest adsf.

rwenz3l commented Sep 19, 2017

Twisted (Python) changed the way ports are set, a proper one-liner would be:

twistd --nodaemon web --port "tcp:port=8888" --path=/path/to/serve

or in a shorter version:

twistd -n web -p "tcp:port=8000" --path .

englishextra commented Oct 5, 2017

isn't it

ruby -run -e httpd 


ruby -run -ehttpd 

there are other -flags that need space after them
also note the last revision of the gist is of 7 Jul 2013.

soulfly commented Oct 23, 2017

Is it possible to test a simple POST request with any of these 1 liners?
I just need to dump all input params to log

I had use Python's SimpleHTTPServer. It's simple and fast.

But when serve a big folder contains tons of files, I want basic filename searching.

Do you know any HTTP server support this function?

I use Everything in Windows. It support HTTP service. For now, I want a linux service.

Thanks for your sharing.

common lisp with roswell:

 ros install clack
 clackup <(echo "(lack:builder (:static :path #'identity) #'identity)")

augnustin commented Nov 22, 2017

Regarding the 2.X python version, I did not like error when pressing Ctrl+C:

^CTraceback (most recent call last):
  File "/usr/lib/python2.7/", line 174, in _run_module_as_main
    "__main__", fname, loader, pkg_name)
  File "/usr/lib/python2.7/", line 72, in _run_code
    exec code in run_globals
  File "/usr/lib/python2.7/", line 235, in <module>
  File "/usr/lib/python2.7/", line 231, in test
    BaseHTTPServer.test(HandlerClass, ServerClass)
  File "/usr/lib/python2.7/", line 610, in test
  File "/usr/lib/python2.7/", line 231, in serve_forever
  File "/usr/lib/python2.7/", line 150, in _eintr_retry
    return func(*args)

So I muted stderr.

Here' full command with port as first argument (from previous comments):

function serve() {
  python -m SimpleHTTPServer $port 2> /dev/null

If someone has a cleanest solution to achieve this, it is welcome! 😄

Globik commented Jan 26, 2018

And in C?



  • sudo npm install serve-static
  • static-server -p 8000

mildmojo commented Feb 2, 2018

Modern npm ships with npx, which will execute a command from an npm package if it's already installed or fetch the package it, run the command, and then remove the package again. So any node example can be shortened to things like:

npx static-server
npx http-server

moshe commented Feb 9, 2018

HTTP server implemented in around 50 lines of bash

Lets you browse files on the default host and port:

caddy browse

Short Caddyfile

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment