Simple command line HTTP server

Question

I have a script which generates a daily report which I want to serve to the so called general public. The problem is I don't want to add to my headaches maintance of a HTTP server (e.g. Apache) with all the configurations and security implications.

Is there a dead simple solution for serving one small HTML page without the effort of configuring a full blown HTTP server?

See answer http://stackoverflow.com/a/4994745 in question One line ftp server in python on [SO]. — manatwork, Feb 20 '12 at 11:04
Indeed! Use FTP, like the World Wide Web did before HTTP was finished! (Although I suppose it wasn't quite as world-wide in early 1990s. ) — Michael Scheper, Sep 08 '16 at 17:42
A large collection of methods have been compiled in this gist — davidcondrey, Dec 17 '16 at 03:15
related: https://stackoverflow.com/questions/5725430/http-test-server-accepting-get-post-requests — Ciro Santilli OurBigBook.com, Jan 30 '24 at 21:10

score 296 · Answer 1 · edited Feb 12 '24 at 10:54

296

Try SimpleHTTPServer:

python3 -m http.server 8080

Or, for Python 2

python -m SimpleHTTPServer 8080

To bind an IP Address, do

python -m SimpleHTTPServer 8080 -b 0.0.0.0

or for Python 3

python3 -m http.server 8080 -b 0.0.0.0

It will serve whatever's in the CWD (e.g. index.html) at http://0.0.0.0:8000.

edited Feb 12 '24 at 10:54

MEEBLOX

3

answered Feb 20 '12 at 15:45

Olivier Lalonde

5,309

32

You can optionally specify a port number like this: python3 -m http.server 1337. You can't specify which IP to bind to as far as I can tell. Note: To listen to port 80 you must have root privileges, e.g.: sudo python3 -m http.server 80 – Hubro Oct 30 '14 at 10:49
1

This one is nice but it has an issue with redirecting to an URL with a trailing slash added. That's why I prefer the twistd version: twistd -n web -p 8000 --path . – Greg Dubicki Jul 14 '15 at 08:49
2

To change default listening port 8080 (with python2) to something else, just put a port number after: python -m SimpleHTTPServer 3000 – Maksim Luzik Feb 01 '19 at 09:56

score 83 · Answer 2 · edited Nov 14 '16 at 15:05

There is a Big list of http static server one-liners:

To get on this list, a solution must:

serve static files using your current directory (or a specified directory) as the server root

be able to be run with a single, one line command (dependencies are fine if they're a one-time thing)

serve basic file types (html, css, js, images) with proper mime types, require no configuration (from files or otherwise) beyond the command itself (no framework-specific servers, etc)

must run, or have a mode where it can run, in the foreground (i.e. no daemons)

For example:

Twisted (Python)
```
twistd -n web -p 8000 --path . 
```

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

Plack (Perl)

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

webfs
```
webfsd -F -p 8000
```
Ruby 1.9.2+
```
ruby -run -ehttpd . -p8000
```

Nikhil Mulley · Answer 3 · 2012-03-02T10:00:22.093

62

Use node.js , fast and lightweight.

Or

just use simple nc netcat command to start a quick webserver on a port and serve the content of a file including the server response headers.

Reference from Wikipedia:

http://en.wikipedia.org/wiki/Netcat#Setting_up_a_one-shot_webserver_on_port_8080_to_present_the_content_of_a_file

{ echo -ne "HTTP/1.0 200 OK\r\n\r\n"; cat some.file; } | nc -l -p 8080
{ echo -ne "HTTP/1.0 200 OK\r\nContent-Length: $(wc -c <some.file)\r\n\r\n"; cat some.file; } | nc -l -p 8080

edited Mar 02 '12 at 10:00

answered Feb 20 '12 at 11:13

Nikhil Mulley

8,315

51

A bare node.js process with only the interactive shell running takes 15MB (7.5 is shared) of RAM. And then you have to run the HTTP server inside it. It is funny that people see it as lightweight. ;-) – jpc Mar 02 '12 at 14:00
yeah I consider it light weight, you can scale well with such less memory footprint. Please read http://thecodinghumanist.com/blog/archives/2011/5/6/serving-static-files-from-node-js However, if you find it cumbersome to use node.js, then the simple netcat utility serves the short lived purpose well. – Nikhil Mulley Mar 02 '12 at 15:28
2

You are of course right if you compare node with Apache but what I found amusing was how node looks when compared to http://cr.yp.to/publicfile.html or something similar. :) – jpc Mar 06 '12 at 10:54
hmmmmm.. ok ;-) – Nikhil Mulley Mar 13 '12 at 05:16
14

+1 for the nc based solution :). Note that the -ne flags for echo may not be portable, using the printf command instead may be a better alternative. – WhiteWinterWolf Nov 05 '16 at 09:35
2

Chrome won't stop throbbing unless you use the second nc command. Also, not both of the nc commands show will quit after responding. You can keep restarting it with: while :; do { echo -ne "HTTP/1.0 200 OK\r\nContent-Length: $(wc -c <some.file)\r\n\r\n"; cat some.file; } | nc -l -p 8080; done. Use ctrl+z to but it to sleep. – Ray Foss Mar 07 '19 at 18:10
@RayFoss what does throbbing mean? Is the purpose of the second nc command that adds Content-Length: $(wc -c <some.file) to the first nc command to stop Chrome from throbbing? – Tim Dec 04 '19 at 11:56
https://unix.stackexchange.com/questions/555544/how-does-this-nc-command-work-as-a-http-server – Tim Dec 04 '19 at 12:16
You can also add the -N flag to nc and both nc commands will work. It will make nc close the socket after sending the file and this is what the browser is waiting for. – Jonas Berlin Dec 04 '19 at 14:15

score 46 · Answer 4 · edited May 11 '18 at 21:18

46

Since version 5.4.0 PHP also has a built-in web server:

php -S localhost:8000

You can Specify the web server's documents directory with -t, for example:

php -S localhost:8000 -t /var/lib/www

If you want to be able to access the server over the network then:

php -S 0.0.0.0:8000 -t /var/lib/www

edited May 11 '18 at 21:18

Jeff Luyet

299

answered Mar 02 '12 at 08:13

manatwork

31,277

2

Wow that was easy and helpful! – Michael-O May 16 '15 at 19:08
This one is really nice if you want to test php-scripts locally. – erik Jul 27 '15 at 09:51

Alexander · Accepted Answer · 2016-09-20T18:33:42.347

43

Yes, nweb.

Can be found here: nweb.c

(previously at ibm.com)

To compile nweb.c:

gcc -O -DLINUX nweb.c -o nweb

edited Sep 20 '16 at 18:33

answered Feb 20 '12 at 11:13

Alexander

9,850

1

It works well, but 2 comments for users: 1) it serves index.html from the provided directory, 2) from nweb --help: "Not Supported: URLs including "..", Java, Javascript, CGI". So, for example, Live.js to automatically refresh the page on file update does not work. – xealits Dec 13 '19 at 13:41
That's right, but you actually just need to add the wanted extensions to the list of mime types for the files to be served. Same for index.html, you can adjust that very easely. – Hexdump May 01 '22 at 15:13

score 23 · Answer 6 · edited Oct 07 '14 at 13:32

23

Node has a simple, fast, light HTTP server module. To install:

sudo npm install http-server -g

(Assuming you have node and npm already installed.)

To run it, using the current directory as the website root:

http-server

This creates a server on http://0.0.0.0:8080/.

edited Oct 07 '14 at 13:32

Mike Cron

5

answered Oct 02 '14 at 22:01

ashes999

351

It works. I have a Node project on a FreeBSD machine, I just run npm install -D http-server inside project directory and then add the following lines to my package.json file: "scripts": { "build": "webpack && cd src/public && http-server" }, now I just need to run npm run build on project directory to start the HTTP server, listening on port 8080 by default. – Megidd Sep 14 '17 at 12:52
3

First I tried "python3 -m http.server", but it's single-threaded and only 1 client can download at a time, the others need to wait. This solution with Node.js works better, due to the async nature of Node. If you want to share a file with several people, use this. – Jabba Sep 14 '17 at 16:14
1

The module may be "light", node.js isn't. You'd be running a JS runtime just to serve static files. – c z Dec 17 '20 at 15:02
To add CORS support: http-server -p 3000 --cors – human Apr 05 '22 at 05:13

Vijay · Answer 7 · 2019-12-04T10:10:36.843

A simple fix/enhancement to a slightly unfairly (imho) down voted answer might also work. Let's set up the html file first ...

echo '<html><head><title>My Test File</title></head><body><h1>OK!</h1></body></html>' > my_file.html

(Thx to Steve Folly for catching my typo in the HTML above. fixed.)

Now you can serve it up with this one-liner:

while true; do echo -e "HTTP/1.1 200 OK\r\nContent-Type: text/html\r\n\r\n" | cat - my_file.html  | nc -l -p 8080; done

This basic idea lends itself to other tricks that might work for you via other cat or subshell ideas such as:

while true; do echo -e "HTTP/1.1 200 OK\r\nContent-Type: text/html\r\n\r\nI think the date is $(date), Have a good day!" | nc -l -p 8080; done

And you could also pass Content-Length as shown in my answer at: https://stackoverflow.com/questions/5725430/http-test-server-accepting-get-post-requests/52351480#52351480 — Ciro Santilli OurBigBook.com, Feb 05 '24 at 17:21

score 6 · Answer 8 · answered Nov 18 '15 at 21:55

6

Simple Ruby one liner to serve a directory:

ruby -run -e httpd . -p 8080

answered Nov 18 '15 at 21:55

Travis Reeder

863

score 5 · Answer 9 · edited Feb 20 '12 at 14:03

5

Try using SimpleHTTPServer in Python.

mkdir ~/public_html
command_to_generate_output > ~/public_html/output.txt

(cd ~/public_html; python -c 'import SimpleHTTPServer,BaseHTTPServer; BaseHTTPServer.HTTPServer(("", 8080), SimpleHTTPServer.SimpleHTTPRequestHandler).serve_forever()')

The first two lines are setup for the web server. The last line creates a simple web server, opened on port 8080, which only serves files from ~/public_html. If only one file is in that directory, then only that is exposed: http://localhost:8080/output.txt.

edited Feb 20 '12 at 14:03

enzotib

51,661

answered Feb 20 '12 at 12:10

Arcege

22,536

that's what i use, just copy the lastline and paste it on a .py file, then run it with python (or make it executable). Keep in mind that you have to run with python 2.x interpreter. – Hanan Feb 20 '12 at 21:40

score 4 · Answer 10 · answered Sep 09 '17 at 15:14

4

try caddy

curl https://getcaddy.com | bash

serve content from /var/www caddy -root /var/www "browse"

now you find the server at http://localhost:2015

answered Sep 09 '17 at 15:14

nwgat

171

I love to just caddy from a local directory and enjoy having a modern and secure webserver. – Duvrai Oct 16 '19 at 08:54

score 3 · Answer 11 · edited May 23 '17 at 12:39

Another option would be to install lighttpd. Following are suggested steps to install lighttpd on a Unbuntu 12.04 LTS.

apt-get update
apt-get upgrade --show-upgraded
apt-get install lighttpd
ifconfig
http://[your-ip-address]:80
/etc/lighttpd/lighttpd.conf (Edit to add server.port)
server.port = "8080"

Note: Documentroot is where all web accessible files will be places. The location is /var/wwww

The above step will install a basic lighttpd web server. For more information refer the following references

References:

score 3 · Answer 12 · answered Mar 12 '16 at 19:21

3

./devd -o -a -P devd:devd .

-o opens url in browser
-a for all interfaces
-P auth user/pass
. serve files in same directory

https://github.com/cortesi/devd/releases

answered Mar 12 '16 at 19:21

nwgat

171

score 3 · Answer 13 · answered Dec 04 '17 at 20:23

I've improved the nc solution a bit so it:

Adds the filename= hint,
Runs in a loop until Ctrl + C,
Saves a PID to /tmp/serveFile-$PORT so you can kill it later easily.

.

#!/bin/bash

FILE=$1;
if [ "$FILE" == "" ] ; then echo "Usage: $0 <file-to-serve> [<port:7979>]"; exit; fi
PORT=${2:-7979}
echo Serving $FILE at $PORT, PID: $$
echo $$ > /tmp/serveFilePID-$PORT

while true; do 
    { echo -ne "HTTP/1.0 200 OK\r\nContent-Length: $(wc -c <$FILE)\r\nContent-Disposition: inline; filename=\"$(basename $FILE)\"\r\n\r\n"; cat $FILE; } | nc -l $PORT
    CODE=$?
    #echo "Code: $CODE";
    if [ $CODE -gt 128 ] ; then break; fi;
done;

rm /tmp/serveFilePID-$PORT

One could also use nc -k -l ... but this way you can

do custom actions between files served,
make several files alternate.

score 2 · Answer 14 · edited May 23 '17 at 11:33

2

Oldschool Ruby WEBrick HTTP server:

#!/usr/bin/env ruby

require 'webrick'
server = WEBrick::HTTPServer.new(:Port => 8000,
                                 :DocumentRoot => '~/webrickroot')

# stop server with Ctrl-C
trap('INT') { server.stop }
server.start

Make sure to modify the DocumentRoot for your setup. See also this.

edited May 23 '17 at 11:33

Community

1

answered Oct 04 '14 at 22:22

score 2 · Answer 15 · answered Apr 04 '16 at 23:00

You can piggy back on xinetd. Put the following config file into /etc/xinetd.d/ and service xinetd reload:

service http
{
  flags = REUSE IPv4
  protocol = tcp
  socket_type = stream
  port = 80
  wait = no
  user = nobody
  server = /bin/echo
  server_args = -e HTTP/1.0 301 Moved Permanently\nContent-Length: 0\nLocation: https://goo.gl/\n\n
  disable = no
}

Works for my redirecting purposes:

# wget 127.0.0.1
--2016-04-04 22:56:20--  http://127.0.0.1/
Connecting to 127.0.0.1:80... connected.
HTTP request sent, awaiting response... 301 Moved Permanently
Location: https://goo.gl/ [following]
...

score 2 · Answer 16 · answered May 02 '12 at 16:45

2

Simple netcat example to put in bash script:

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

answered May 02 '12 at 16:45

hotrider

73

15

That entirely fails to speak HTTP. – derobert Aug 06 '14 at 11:54
1

I tried while [ 1=1 ] ; do echo "TEST" | nc -l 80; done - going to http://127.0.0.1 indeed returns the contents. I had to do that as root though. So in an extremely crude way - it can get the job done, and I like that. I tried going to http://my-hostnname.local on another machine in the LAN and it worked too. – unfa Dec 11 '17 at 11:33

score 2 · Answer 17 · edited Oct 13 '22 at 07:23

2

I used these instructions to install a web server on my CentOS machine without having to use sudo or touch any system files:

First install node (see the latest available version of the nodejs package here and change the package filename in the wget):

$ cd ~
$ wget https://nodejs.org/download/release/latest/node-v18.10.0-linux-x64.tar.gz
$ tar node-v18.10.0-linux-x64.tar.gz

then install http-server:

$ export PATH=~/node-v18.10.0-linux-x64/bin:$PATH
$ npm install http-server

then run http-server on port 12321:

$ ~/node-v18.10.0-linux-x64/bin/node_modules/http-server/bin/http-server -p 12321

edited Oct 13 '22 at 07:23

αғsнιη

41,407

answered Oct 04 '17 at 19:51

user674669

133

For future readers coming here from search: this is using a sledgehammer to crack a nut. There are many easier and smaller solutions (e.g. https://stackoverflow.com/questions/4994638/one-line-ftp-server-in-python/4994745#4994745 suggested in question comments). – kiler129 Dec 21 '22 at 20:15

score 1 · Answer 18 · answered Mar 12 '16 at 20:24

SFK worth mentioning here

http://stahlworks.com/dev/swiss-file-knife.html

an excellent multipurpose tool with no dependencies

available in both deb and rpm flavours

sfk httpserv -port 1234

will serve current directory

sfk httpserv -port 1234 -rw

will also allow file uploading

score 1 · Answer 19 · answered May 10 '20 at 07:08

My five cents, written in shell: https://gitlab.com/mezantrop/supermatic

Supermatic can run on FreeBSD and any other OS which has Bourne Shell and inetd-like daemon. It serves static HTML and TXT files along with GIF, JPEG and PNG image formats. What's about any other standards and features? No, never heard of them.

score 1 · Answer 20 · answered Feb 12 '21 at 17:18

1

A docker based one liner so you don't have to have any particular language installed:

docker run --rm -i -p 8000:8000 -v $(pwd):/app -w /app ruby:alpine ruby -run -ehttpd . -p8000

answered Feb 12 '21 at 17:18

Travis Reeder

863

score 0 · Answer 21 · answered Aug 30 '16 at 18:07

0

Pure bash: A web server in a shell script.

Also, you'll need xinetd (I believe available in any distro) to listen port and run the script when needed, so you don't have to code tcp stack etc in bash.

answered Aug 30 '16 at 18:07

Putnik

886

Janardhan B. Chinta · Answer 22 · 2021-03-19T02:31:22.473

0

To nweb.c I have added directory listing functionality. https://github.com/jbabuc/nweb

nweb.c, simple http server with directory listing.
nwebs, statically compiled binary for linux.

edited Mar 19 '21 at 02:31

answered Mar 18 '21 at 13:12

Janardhan B. Chinta

1

Welcome to the site, and thank you for your contribution. Please note that nweb was already mentioned in the accepted answer. Please review your answer and check if you can add anything new to make it more distinct. Alternatively, consider submitting an edit proposal to the accepted answer. – AdminBee Mar 18 '21 at 14:00

Simple command line HTTP server

22 Answers22

Linked