Skip to main content

A simple Python HTTP server for your sysadmin toolbox

If you need a quick and easy web service, the Python SimpleHTTPServer might be right for you.
Image
A tree python

Sometimes as admins, we need to share files across systems quickly. For whatever reason, we need to get a single tar or conf file from one system to another, or maybe copy a group of files between systems. We find that we need to install a package or utility to share the files, or we may need to enable a feature to share the content. Regardless of the situation, we can use Python's SimpleHTTPServer module as a quick web server.

Python -m SimpleHTTPServer

The SimpleHTTPServer module is a Python module that enables a developer to lay the foundation for developing a web server. However, as sysadmins, we can use the module to serve files from a directory.

Usage

Python must be installed to use the SimpleHTTPServer module. Python may be installed as a dependency to an application or service that is already running on the system. Run python -V to verify its presence. To use the module for our purposes, run the following command from the directory with the files we want to share:

python -m SimpleHTTPServer

* Note: The module has been renamed http.server in python3

The module loads and serves any files within the directory on port 8000 by default.

Image
8000

From the remote system, browse to http://<ip>:8000 using your browser of choice. A directory listing will be displayed where you can open or download any file.

Image
dircropped

Another option is to use wget or curl to download the files to the remote system.

wget http://<ip>:8000/filename
curl http://<ip>:8000/filename

This simple local HTTP server is a nice little utility to use in those times when you need to transfer files quickly across systems.

Use cases

This tip is not a replacement for actual file-hosting solutions in business environments. The SimpleHTTPServer module is actually a development tool used as a framework tool to lay the foundation for a full-blown web server with all the necessary security features included. However, we can use the module for our purposes to:

  • Quickly serve kickstart files in a pinch - Copy the /root/anaconda-ks.cfg or /root/original-ks.cfg to a folder and serve with python -m SimpleHTTPServer. Edit the grub config at boot, and away you go.
  • Share a file to/from a VM - Copy a file to a folder and serve with python -m SimpleHTTPServer.
  • Serve a file on an allowed port of firewall - Copy a file to a folder and serve with python -m SimpleHTTPServer port

Other options

You can also use a while loop with ncat or /dev/tcp/host/port for transport… but that is another article. I hope you find this option a useful tool in your toolbox.

Gotchas

You may need to open ports in your firewall:

# firewall-cmd --add-port=portnumber/tcp

[ Download now: A sysadmin's guide to Bash scripting. ]

Topics:   Networking   Linux  
Author’s photo

Stephen Wilson

Stephen Wilson is a Senior Storage Consultant with Red Hat, Inc. He has over 20 years of experience in information systems management. His professional interests include system administration, cybersecurity, cloud technologies, and virtualization. More about me

Try Red Hat Enterprise Linux

Download it at no charge from the Red Hat Developer program.