How to Install Whoogle on Windows: The Ultimate Guide (2025 Edition)

Install Whoogle on Windows– In the mass surveillance and data tracking era, Whoogle Search stands as a beacon of privacy. It is a self-hosted, privacy-respecting metasearch engine that strips out ads, tracking cookies, and AMP links from Google Search results, giving you a clean, fast, and respectful search experience. This guide will walk you through installing Whoogle on Windows with precise steps, rich technical detail, and useful insights.

What is Whoogle and Why You Should Use It

Whoogle is a lightweight alternative front-end to Google Search. It offers:

• No ads or sponsored content
• No JavaScript (optional mode)
• No cookies or tracking
• No AMP links or URL tracking parameters
• Support for Tor/HTTP/SOCKS proxies
• DDG-style bangs (!w, !yt, etc.)
• Custom themes and CSS
• Full-resolution image previews
• Fast performance with minimal resource use

System Requirements for Installing Whoogle on Windows

Before we proceed with installation, ensure your system meets the following requirements:

• Windows 10/11 (64-bit)
• Python 3.8+ or Docker Desktop (for Docker method)
• Git (for cloning repositories)
• pip (Python package manager)

You can choose between a native Python installation or a Docker-based setup, detailed below.

Method 1: Installing Whoogle on Windows Using Python (Without Docker)

This method is ideal if you’re unfamiliar with Docker or prefer lightweight setups.

Step 1: Install Git for Windows

1. Download Git from the official website.
2. Run the installer and follow the default setup steps.
3. After installation, open Git Bash or Command Prompt to confirm by running:
4. git –version

Step 2: Install Python and pip

1. Download Python from the official Python website.
2. During installation, check the box “Add Python to PATH”.
3. After installation, verify with:
4. python –version
   pip –version

Step 3: Clone Whoogle Repository

Step 4: Create a Virtual Environment (Optional but Recommended)

Step 5: Install Required Python Packages

• pip install -r requirements.txt

Step 6: Run Whoogle Locally

• python app/main.py

By default, Whoogle will run at http://localhost:5000. Open your browser and enter the URL to start searching anonymously.

Method 2: Installing Whoogle on Windows Using Docker (Recommended for Ease and Portability)

Step 1: Install Docker Desktop

1. Download Docker Desktop from the Docker website.
2. Follow the installer instructions.
3. Enable WSL 2 backend if prompted (this improves performance on Windows).
4. After installation, confirm Docker is running using:
5. docker –version

Step 2: Pull the Official Whoogle Docker Image

• docker pull benbusby/whoogle-search

Step 3: Run the Docker Container

Whoogle will now be accessible at http://localhost:5000.

Optional: Add Environment Variables for Custom Configuration

You can customize the instance with parameters:

Whoogle Features That Make It a Google Alternative

1. Total Privacy

Whoogle removes everything that directly connects you to Google servers — no tracking, ads, or user profiling.

2. Bang Searches

Type !yt ChatGPT or !w Whoogle to directly search platforms like YouTube, Wikipedia, or Reddit.

3. Proxy and Tor Support

Whoogle is compatible with HTTP/SOCKS proxies and can run over Tor for anonymous browsing.

4. Custom Themes

Modify your interface with custom CSS or use built-in light, dark, or system themes.

5. Portable Deployment

Deploy Whoogle locally, on a private server, or even host it on services like Heroku, Railway, or a VPS.

How to Set Whoogle as the Default Search Engine in Your Browser

For Google Chrome:

1. Go to chrome://settings/searchEngines.
2. Click Add.
3. Enter:
   • Search engine: Whoogle
   • Keyword: whoogle
   • URL with %s: http://localhost:5000/search?q=%s
4. Click the three dots next to it and set it as the default.

For Firefox:

1. Visit http://localhost:5000.
2. Click the three-dot menu in the search bar.
3. Select Add “Whoogle”.
4. Go to Settings > Search > Default Search Engine and set Whoogle.

Securing Your Whoogle Instance

Use a Reverse Proxy (e.g., Nginx or Caddy)

Set up a reverse proxy with SSL to access Whoogle securely via HTTPS.

Add Basic Authentication

To restrict public access, you can add basic auth via reverse proxy or Docker environment variables.

Troubleshooting Common Issues

Port 5000 is Already in Use

Change the port by modifying the run command:

• docker run -d -p 5050:5000 …

Whoogle Not Loading

Check Docker logs:

• docker logs whoogle

Or for the Python method:

• python app/main.py –debug

Uninstalling Whoogle from Windows

Docker Method:

Python Method:

Just delete the cloned folder and virtual environment:

Wrap Up: Power Your Private Search

Installing Whoogle on Windows gives you a private, efficient, customizable search experience free from corporate surveillance. Its lightweight design and comprehensive features make it the perfect tool for tech-savvy users who value digital privacy.