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 .

Or:

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

Depends on Twisted.

Ruby

$ ruby -rwebrick -e'WEBrick::HTTPServer.new(:Port => 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.

Perl

$ 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 127.0.0.1:8000

Credit: /u/prawnsalad and MattLicense

No directory listings.

Erlang

$ 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

webfs

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

Meta

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

Erlang:

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
Owner

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.

Owner

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

Owner

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
Owner

willurd commented Jul 7, 2013

@nobu Added, thanks!

Owner

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

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

Thanks to:
http://stackoverflow.com/questions/8058793/single-line-python-webserver

Created a shell function for this https://gist.github.com/ahmedelgabri/8122545 "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:

./srvdir

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.

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 github.com/rif/spark
$ spark -port 8000 .

PowerShell

$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

PowerShell.exe -nop -enc JABIAHMAbwA9AE4AZQB3AC0ATwBiAGoAZQBjAHQAIABOAGUAdAAuAEgAdAB0AHAATABpAHMAdABlAG4AZQByADsAJABIAHMAbwAuAFAAcgBlAGYAaQB4AGUAcwAuAEEAZABkACgAIgBoAHQAdABwADoALwAvACsAOgA4ADAAMAAwAC8AIgApADsAJABIAHMAbwAuAFMAdABhAHIAdAAoACkAOwBXAGgAaQBsAGUAIAAoACQASABzAG8ALgBJAHMATABpAHMAdABlAG4AaQBuAGcAKQB7ACQASABDAD0AJABIAHMAbwAuAEcAZQB0AEMAbwBuAHQAZQB4AHQAKAApADsAJABIAFIAZQBzAD0AJABIAEMALgBSAGUAcwBwAG8AbgBzAGUAOwAkAEgAUgBlAHMALgBIAGUAYQBkAGUAcgBzAC4AQQBkAGQAKAAiAEMAbwBuAHQAZQBuAHQALQBUAHkAcABlACIALAAiAHQAZQB4AHQALwBwAGwAYQBpAG4AIgApADsAJABCAHUAZgA9AFsAVABlAHgAdAAuAEUAbgBjAG8AZABpAG4AZwBdADoAOgBVAFQARgA4AC4ARwBlAHQAQgB5AHQAZQBzACgAKABHAEMAIAAoAEoAbwBpAG4ALQBQAGEAdABoACAAJABQAHcAZAAgACgAJABIAEMALgBSAGUAcQB1AGUAcwB0ACkALgBSAGEAdwBVAHIAbAApACkAKQA7ACQASABSAGUAcwAuAEMAbwBuAHQAZQBuAHQATABlAG4AZwB0AGgANgA0AD0AJABCAHUAZgAuAEwAZQBuAGcAdABoADsAJABIAFIAZQBzAC4ATwB1AHQAcAB1AHQAUwB0AHIAZQBhAG0ALgBXAHIAaQB0AGUAKAAkAEIAdQBmACwAMAAsACQAQgB1AGYALgBMAGUAbgBnAHQAaAApADsAJABIAFIAZQBzAC4AQwBsAG8AcwBlACgAKQB9ADsAJABIAHMAbwAuAFMAdABvAHAAKAApAA==

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

or

go get github.com/kidoman/serve

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.

https://github.com/kidoman/serve

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

npm install -g glance
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 Rack::File.new('.')"

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.

views.py named file can contain importd/django views in case you want to grow.

avsm commented Jun 23, 2014

OCaml is

opam install cohttp async
cohttp-server-async

or

opam install cohttp lwt ssl
cohttp-server-lwt

Livereload

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 {
  port="${1:-3000}"
  http-server . -p $port
}

Then just run

serve 5000

nodejs

$ 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

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.

https://github.com/carlos-jenkins/webdev

Installation

pip install webdev

Usage

$ 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: 0.0.0.0
  -p PORT, --port PORT  Port to listen to. Default: 8080.

beno commented Sep 7, 2015 edited

Crystal

Here's one for Crystal. Speedy!

crystal eval 'require "http/server"; h = HTTP::StaticFileHandler.new("."); HTTP::Server.new(8000) {|r| h.call(r) }.listen'

updated:

crystal eval 'require "http/server"; HTTP::Server.new(8000, HTTP::StaticFileHandler.new(".")).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.

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 '/CN=name-you-want.example.com' -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 https://metacpan.org/pod/HTTP::Server::Brick

vwochnik commented Mar 5, 2016

For Go, there is a simple HTTP server at https://github.com/vwochnik/gost

go install vwochnik/gost

Then, simply run

gost

no pul requests with gist, made a syntactic sugar fix to php https://gist.github.com/maximveksler/a2651d78f1c9da6a686332780d3f12f4/revisions

qwIvan commented Apr 23, 2016 edited

install
npm install anywhere -g

run
anywhere

withakay commented May 1, 2016

Haskell (via the maid module https://hackage.haskell.org/package/maid).

install
cabal install maid

serve cwd on default port 3000
maid

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(Rack::Directory.new('./public'))"

For Laravel (PHP):

php artisan serve

or

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

hickford commented Aug 2, 2016

I like "Ran: a simple static web server written in Go" https://github.com/m3ng9i/ran

ran -p 8000

ebraminio commented Aug 12, 2016 edited

Mine, zero install if node.js available: pad.js.org, source
curl pad.js.org | 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 edited

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

main.go

import "net/http"

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

> go run main.go

olejorgenb commented Dec 26, 2016 edited

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

mholt commented Jan 3, 2017 edited

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
	else
		php -S localhost:"$@"
	fi
}

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 edited

@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 github.com/yudai/gotty
$ $GOPATH/bin/gotty -a 127.0.0.1 -p 8000 -w cat file.ext

Grinnz commented Mar 29, 2017 edited

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

$ cpan App::SimpleHTTPServer
$ serve_dir

(defaults to port 8000)

3rdp commented Apr 16, 2017 edited

$ npm install -g serve
$ serve .

(this will host . at localhost:5000)

yihui commented Apr 29, 2017

R

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 .

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