May 08, 2026

Setting up a local web server with Python

Cover Image

Setting Up a Local Web Server with Python: A Beginner's Guide

Want to quickly test out a website you're building? Need to serve up some files locally? You don't need a fancy web server setup. Python has a simple built-in solution for creating a local web server with just one line of code! This is perfect for development, testing, and sharing files on your local network.

Why Use Python?

Python's built-in HTTP server is incredibly easy to use. It's perfect for situations where you don't need the full power of Apache or Nginx. Think:

  • Quickly previewing HTML, CSS, and JavaScript files.
  • Sharing files on your local network.
  • Testing your website during development.

The Magic One-Liner

Ready for the magic? Open your terminal, navigate to the directory you want to serve, and run this command:

python3 -m http.server

That's it! By default, this starts a server on port 8000. You can access your files in your browser by going to http://localhost:8000.

Changing the Port

Want to use a different port? Just add the port number to the end of the command:

python3 -m http.server 8080

Now your server will be running on port 8080. You can access it at http://localhost:8080.

Python 2 (Legacy - Use with Caution)

If you're using an older system with Python 2 (which is generally not recommended anymore), the command is slightly different:

python -m SimpleHTTPServer

This defaults to port 8000, but you can change it the same way as with Python 3:

python -m SimpleHTTPServer 8080

Important Note: Python 2 is no longer officially supported. Try to use Python 3 whenever possible for security and compatibility reasons.

Stopping the Server

To stop the server, simply press Ctrl+C in your terminal.

Security Considerations

Keep in mind that this is a very basic web server. It's not designed for production use and doesn't include security features like authentication or encryption. Only use this on trusted networks for testing and development purposes. Avoid serving sensitive data with this method.

Conclusion

Setting up a local web server with Python is a breeze! It's a valuable tool for developers and anyone who needs to quickly serve files locally. Have fun experimenting!