Create a gist now

Instantly share code, notes, and snippets.

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}]).'

If you ever use Drupal, drush 5+ has

$ drush rs 8080

Another Ruby:

$ gem install adsf
$ adsf

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.


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


Oh well, let me rephrase it then :)


@lvm Added, thanks!


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.


Ruby 1.9.2+:

$ ruby -run -ehttpd . -p8000

@nobu Added, thanks!


@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



$ 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.


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.


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

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


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

$ gem install serve
$ serve
$ npm install -g beefy
$ beefy

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


Also for ruby

$ gem install httpit
$ httpit
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

Harp, static web server with built-in preprocessing.

$ npm install -g harp
$ harp server

Rack (ruby)

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

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?

$ 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.


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..


Create an alias in your .bashrc

function serve {
  http-server . -p $port

Then just run

serve 5000


$ npm install startserver -g
$ server 8080

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


Very coool gist!! Made my day B-)


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_)


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


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 edited


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?


The powershell one should be.


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.


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

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


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 edited

npm install anywhere -g



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


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

ran -p 8000
ebraminio commented Aug 12, 2016 edited

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

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


darkhttpd . (deps: darkhttp)

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