Whoogle Docker Guide

How to use Google without being tracked

We have to admit that most of use use Google search services as a routine, but at the same time we can get tired of the targeted advertisement.

Whoogle will help us with it.

It will allow us to use Google search engine locally, so our data is not leaked to their servers.

Whoogle - Docker container:

Docker - First steps

One recurrent topic that has to be addressed in the first place is to setup docker in our machine.

apt-get update && sudo apt-get upgrade && curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh && docker version

With that you will have Docker running. Now, lets include also Docker-Compose, as it will make this installation (and many others) really simple.

apt install docker-compose -y
#docker-compose --version

The configuration file that we will use today to deploy Whoogle is:

---
version: "2"
services:
  whoogle:
    image: benbusby/whoogle-search:latest
    container_name: whoogle
    ports:
      - 5000:5000 #accessible through the port 5000
    restart: unless-stopped

Deploy Whoogle with CLI

Providing that the previous steps are clear, we can jump to our terminal and use:

nano docker-compose.yml

This will open a text editor, where we can paste the following configuration file:

To save, use CTRL+O, then CTRL+X to exit.

Then just deploy the service with:

sudo docker-compose up -d

You are ready to discover the devices in your LAN, the service will be running in 0.0.0.0:5000 or localhost:5000 if you use the configuration file as it is provided.

If you have deployed it in one device at home, you can use it from any other connected at the same router, just use the internal IP of the device in which you made the deployment.

You can check that in Linux with:

hostname -I

Configuring Whoogle

When will access Whoogle, you can setup these configuration fields:

The list is longer than we can see in this snapshot, so I recommend you to spend sometime making Whoogle a perfect fit for you.

You can even customize the CSS for WHoogle UI!

Whoogle with NGINX and secure SSL

Its great to have Whoogle running, but even better is to access it with SSL.

For this we can use Whoogle combined with another service, NGINX , that will help us make the site secure.

Let me show you how to do it for free thanks to duckdns domains.

Configure DuckDNS and NGINX

Visit DuckDNS site and have your subdomain pointing at your local IP where Whoogle is running. (You can also use it with public IPs, but lets leave that for the future).

The UI is really intuituve, and once you login, just fill the IP like so:

Great, we have DuckDNS ready, now, make sure to setup NGINX running and include the Whoogle Service:

And now let’s make NGINX and DuckDNS work together to have our SSL certificate:

Whoogle and NGINX

We need to tweak our initial Whoogle configuration file so that NGINX is able to detect it.

---
version: "2"
services:
  whoogle:
    image: benbusby/whoogle-search:latest
    container_name: whoogle
    ports:
      - 5000:5000 #accessible through the port 5000
    restart: unless-stopped
    networks: ["nginx_default"]


networks:
    nginx_default:
        external: true

With this change, our Whoogle container is in the same Docker network as NGINX and we are able to have secure connections.

FAQ

How to Deploy Nginx Proxy Manager

If you are interested in deploying a separated NGINX instance with Docker, I already created a guide for that here.