May 06, 2026

Setting up a local web server with Python

Cover Image

Hey everyone, and welcome back to the blog! Today, we're diving into a super useful (and surprisingly easy!) topic: setting up a local web server using Python. Why would you want to do this? Well, it's perfect for testing out your web development projects, sharing simple files over your local network, or even just messing around with some basic server-side scripting. Plus, Python makes it ridiculously simple.

Why Python? It's the Swiss Army Knife of Coding!

Python is fantastic for this because it has a built-in module called http.server. This module provides a basic HTTP server that you can spin up in seconds with just a single command. No need to install complex software or configure Apache! Let's get started!

Step-by-Step: Your Local Web Server is Just a Command Away

  1. Open your Terminal: This is where the magic happens. Fire up your terminal application. On Linux, it's usually accessible through your application menu or by searching for "terminal".

  2. Navigate to Your Project Directory (Optional): If you want to serve files from a specific folder, use the cd command to navigate there. For example, if your files are in a folder called "mywebsite" on your desktop, you'd type: cd ~/Desktop/mywebsite

  3. Run the Server: This is the big one! Type the following command and press Enter:

    python3 -m http.server

    If you have Python 2 installed and prefer to use that, use: python -m SimpleHTTPServer. Note: Python 2 is generally considered outdated, so using Python 3 is highly recommended.

  4. Success! By default, the server will start on port 8000. You should see a message in your terminal that looks something like "Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/)"

  5. Access Your Server: Open your web browser (Chrome, Firefox, Safari, etc.) and type localhost:8000 into the address bar. You should see a listing of the files in the directory you're serving from (or the "mywebsite" folder if you navigated there in step 2).

Customizing Your Server

Want to get a little fancier? Here are a couple of tweaks you can make:

  • Changing the Port: To use a different port (maybe 8080, or your favorite number!), add the port number after the command:

    python3 -m http.server 8080

    Now access your server at localhost:8080.

  • Serving from a Different Directory: You can specify a directory directly in the command:

    python3 -m http.server --directory /path/to/your/directory

Stopping the Server

When you're done, simply press Ctrl+C in your terminal window to stop the server.

Wrapping Up

That's it! You've successfully set up a local web server with Python. Pretty cool, right? This is a fantastic tool for web developers and anyone who needs a quick and easy way to share files. Go forth and experiment! Let me know in the comments if you have any questions or cool uses for this technique!