Mar 15, 2026

Setting up a local web server with Python

Cover Image

Hey there, fellow tech enthusiasts! Ever wanted to quickly spin up a simple web server on your Linux machine? Maybe you're testing some frontend code, sharing a file, or just curious about how web servers work. Well, guess what? Python makes it incredibly easy to do just that! And the best part? You probably already have Python installed!

Why Use Python for a Local Web Server?

Good question! Here's why Python is a fantastic choice for this task:

  • Simplicity: Python's built-in http.server module requires minimal code.
  • Ubiquity: Python is pre-installed on most Linux distributions.
  • Speed: For quick testing and sharing, it's plenty fast.
  • Cross-Platform: Works on Windows and macOS too!

Setting it Up: Step-by-Step

Alright, let's get our hands dirty! Follow these simple steps to get your local web server up and running:

  1. Open your terminal: This is where the magic happens.
  2. Navigate to the directory you want to serve: Use the cd command to move to the directory containing the files you want to share. For example, if your files are in /home/youruser/mywebsite, you would type cd /home/youruser/mywebsite.
  3. Run the Python command: Type the following command and press Enter:
    4. python3 -m http.server
  4. (Optional) Specify a port: By default, the server runs on port 8000. If you want to use a different port (e.g., 8080), add it to the command:
    5. python3 -m http.server 8080

Testing Your Web Server

Now that the server is running, let's see if it works! Open your web browser and type http://localhost:8000 (or http://localhost:8080 if you specified a different port) into the address bar. You should see a listing of the files in the directory you specified!

Sharing Your Files (with Caution!)

If you want to share your files with others on your local network, you need to find your computer's IP address. You can usually do this by running the command ip addr in your terminal and looking for the IP address associated with your network interface (usually something like eth0 or wlan0). Then, other users on your local network can access your files by typing http://YOUR_IP_ADDRESS:8000 into their browser.

Important Note: This method is primarily for local development and testing. It's generally not recommended for serving files to the public internet due to security concerns. For production environments, consider using more robust web servers like Apache or Nginx.

Stopping the Server

When you're finished, simply press Ctrl+C in your terminal to stop the Python web server.

Conclusion

And that's it! You've successfully set up a local web server using Python. It's a quick and easy way to share files, test your web development projects, and learn a little bit more about how web servers work. Happy coding!