Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Small Development Web Server

Project description


This is a small web server for development or sharing purposes. It allows to serve through HTTP any directory in your machine. It is based on Python famous SimpleHTTPServer and it only depends on a Python 2.7 interpreter and the standard library.

In contrast to SimpleHTTPServer this development web server:

  • Allows the serving folder can be passed as the first positional argument. Defaults to current directory.
  • Will respond with 404 if the serving folder is removed; instead of crashing.
  • Will return back to normal operation if the folder is recreated. Very useful with build systems that perform clean actions.
  • Bind IP can be specified in case security is a must while developing.

As with SimpleHTTPServer this web server can:

  • Specify binding port.
  • List directories.
  • Serve index.html or index.html automatically as the directory entry.


pip install webdev


$ webdev --help
usage: webdev [-h] [-v] [--version] [-i IP] [-p PORT] [-f] [-r RANGE] [-u]

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.
  -f, --force-port      Force the use of the given port.
  -r RANGE, --range RANGE
                        Number of ports to try from the base port
  -u, --future          Ignore if the folder to server doesn't exists yet




  • Added support for Python 3 (issue #5).
  • Added support for incremental automatic port selection (issue #2).
  • Added the --future flag that allows the webserver to serve a non-existent folder, assuming it will be created in the future (issue #3).


  • Ctrl+C is now handled (issue #4).


  • Initial release.


Copyright (C) 2015-2016 Carlos Jenkins <>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.

Project details

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
webdev-1.1.0.tar.gz (8.3 kB) Copy SHA256 hash SHA256 Source None Mar 23, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page