Install and Setup WhatsApp Proxy on Linux
General Linux Topic

Surely, all users around the world have heard the name of the WhatsApp application because WhatsApp is known as the most popular messaging and communication application in the world. WhatsApp was initially offered only for iPhone, but contrary to the imagination of WhatsApp users, it took a step beyond being limited, and now, fortunately, with its progress, it can be used on all operating systems and platforms.

One of the most common versions of WhatsApp to use is its web version, which has made it easier for many users to communicate with others. With the development and popularity of WhatsApp, now the owner of Facebook has bought it and named it Meta. The capabilities and facilities of WhatsApp almost solve the main needs of users in remote communicating with others; also the purpose of this online tool is to facilitate communication between people from a distance, for this reason, it Has become the most popular and most used application for private communication between people in the world.

Sometimes, for some reason, some governments impose restrictions on access to communication applications and even the Internet and causing disruptions in people’s communication. Therefore, users are looking for a solution to bypass the limitations of communication applications such as Telegram, WhatsApp, etc., so that they can communicate with their classmates and families remotely without disruption.

Installing and setting up WhatsApp Proxy in Linux is one of the solutions to bypass such restrictions in accessing the WhatsApp messenger application and establishing a secure and private connection. In addition to installing and setting up a proxy, setting up a VPN on the server is another way to bypass restrictions on the use of communication applications or specific content on some websites. you can easily overcome such problems, By using our training articles related to setting up VPNs on Linux VPS. We suggest that if you intend to set up a VPN on a Linux server, read how to set up L2TP VPN Server on Mikrotik.

Fortunately, due to the restrictions on the use of WhatsApp in some geographic areas imposed by governments, the WhatsApp developer team has recently provided the WhatsApp Proxy feature, which in this article, we will teach you how to install WhatsApp Proxy in Linux step by step. Stay with us until the end of this article to get rid of the restrictions imposed on WhatsApp by governments.

What is the advantage of WhatsApp proxy support?

As we have explained, recently WhatsApp provided the possibility of bypassing the restrictions imposed by the government on the use of WhatsApp messenger with the free support of WhatsApp Proxy. Proxy Server is a router or system that acts as an interface between users (device or service) and the Internet. Thus, it helps prevent cyber attackers from entering a private network.

Proxy servers offer different levels of performance, security, and privacy depending on the type of consumption, needs, or policies of people. Since WhatsApp contains your personal information related to your friends, colleagues, and family, setting up WhatsApp Proxy is a layer of protection and safety for your communications. Therefore, WhatsApp Proxy prevents direct connection to the WhatsApp application and receives and sends messages as an intermediary.

This feature only breaks the filters in the WhatsApp application and does not affect bypassing the restrictions imposed on other applications, but since it is very compatible, it allows the running of a third-party proxy Simultaneously to remove other restrictions. Therefore, you can use other proxies at the same time as installing and setting up WhatsApp Proxy without interfering with each other. This advantage allows you to use a separate and more advanced proxy to increase security when using whats app proxy.

Prerequisite for setting up WhatsApp proxy on Linux

  • Linux VPS
  • Installing and activating Docker on Linux VPS.
  • A user account withsudoprivileges
  • Fixed and public IP address to communicate with outside the network
  • Access to the command line

Note: Windows VPS can also be used to set up a WhatsApp proxy server, but Linux VPS is a more ideal and efficient option for setting up WhatsApp Proxy.

WhatsApp Proxy Setting up steps

Follow the instructions below to activate the WhatsApp proxy service.

Step 1: Update the Linux system package repository

First, it is better to update the Linux system package repository by running the following commands:

  • Debian/Ubuntu distributions:

sudo apt update && sudo apt upgrade
  • CentOS, Fedora, and RHEL-based distributions:

sudo yum update -y

Step 2: Download and install Docker

If Docker and Docker-compose are installed on your Linux system, you do not need to execute the commands of this step; but if Docker is not installed on your Linux VPS, run the following commands according to the distribution you are using:

  • Installing Docker on Debian/Ubuntu distributions:

sudo apt install
  • Installing Docker on CentOS, Fedora, and RHEL-based distributions:

sudo yum install docker

Step 3: Start and enable the Docker service

After Docker installation, it is time to enable and start the Docker service, for this purpose you should run the following commands:

sudo systemctl enable docker

sudo systemctl start docker

By running the previous commands, your operating system will automatically shut down and then restart.

Step 4: Checking the Docker service execution status

To ensure that the Docker service is running correctly, enter the following command:

docker --version


Docker version 20.10.12, build 20.10.12-0ubuntu4

Step 5: Install docker-compose

Then install docker-compose by running the following command:

# Download the pkg

sudo curl -L$(uname -s)-$(uname -m) -o /usr/bin/docker-compose

# Enable execution of the script

sudo chmod +x /usr/bin/docker-compose

Step 6: Check the docker-compose installation

To ensure that docker-compose is installed and the commands are executed correctly, run the following command:

docker-compose --version


Docker-compose version 1.29.2, build 5becea4c

Step 7: Download the repository and Clone WhatsApp Proxy

After making sure to install Docker and Docker-compose, you need a repository where you can easily install the WhatsApp Proxy server using the pre-set codings of that repository. So for Clone whats app proxy enter the following command:

git clone

After the file is cloned, then set the current path to the project location by running the following command:

cd proxy/

Step 8: Start the WhatsApp Proxy service

Although you can use Docker and Docker-compose to run the WhatsApp Proxy service, if you don’t wish to be involved in creating and destroying the container, it’s better to use Docker-compose because, in certain circumstances, it can automatically destroy and recreate the container without user intervention. To run Docker-compose, run the following command:



docker compose

But if the execution of the previous commands encountered an error, use the following command. Therefore, to start the proxy server automatically in the conditions you need it, you should enter the following command:

docker-compose -f /path/to/this/repo/docker-compose.yml up -d


Starting a8de5cb28f3e_whatsapp_proxy… done

By receiving a confirmation message at the output, you can rest assured that you have successfully set up WhatsApp Proxy. Now you can use this proxy on your mobile phone to connect to the WhatsApp application, for this purpose, you need to know the IP address of the device on which the proxy is running by entering the following command:

ip -br addr

How to set Proxy for WhatsApp

Congratulations, you have successfully installed and set up the WhatsApp Proxy server in Linux. Now you can test the proxy you configured, on your phone and use the WhatsApp Proxy server to bypass the restriction of not connecting to WhatsApp.

After knowing the IP address of the device where the proxy is installed and running, we will test the WhatsApp Proxy in the WhatsApp application on your mobile phone.

To activate the proxy server in WhatsApp settings, in the situation that you are unable to connect to WhatsApp despite having access to the Internet, use the instructions we provide so that you can communicate with others and send and receive messages using the proxy server. (In this tutorial, we will apply the WhatsApp proxy settings on the IOS system. However, it is not particularly different from Android.)

1. Update the WhatsApp application first and then enter the WhatsApp application and select the “Settings” option. The Settings option in WhatsApp is available at the bottom of the screen, in the right corner with the cog icon.

2. Find and select the “Storage and data” option in the Settings menu.

Setting WhatsApp Proxy on iOS



3. Then select the “proxy” option.

Setting WhatsApp Proxy on iOS

4. Activate this feature by switching the button opposite “Use proxy“. (changing the color of the button in front of “Use proxy” from gray to green means that the feature is activated)

Setting WhatsApp Proxy on iOS

5. After “Use proxy” is activated, it is possible to enter the IP address of the proxy server. You must type the IP address of the proxy server that you saw in the previous step and connect to WhatsApp by activating WhatsApp Proxy.

After connecting to the proxy server, you will see the word Connected under the IP Address.

As a result, after connecting to the Proxy server, your WhatsApp will be connected and you will be able to communicate online with your friends and relatives without facing any challenges.


Although WhatsApp is safe without using a proxy because of advanced end-to-end encryption, using a proxy is also effective in increasing the security of your communications by hiding your IP address, identity, and online behavior.

This feature is applied in the new versions of whats App, after configuring a strong and secure proxy server, you can use the Proxy feature in WhatsApp by referring to Settings > Storage and Data > Proxy > Use Proxy and entering the proxy address.

By configuring the WhatsApp Proxy server, you can bypass the restrictions imposed on WhatsApp through the main interface of the WhatsApp program and remove the filter. One of the important advantages of proxy is to hide the identity and online behavior of users.


As you can see, the steps to install and set up WhatsApp Proxy on Linux are not complicated. By following the instructions we have provided, you can easily bypass the restrictions imposed on WhatsApp. Take advantage of the new feature of WhatsApp because this feature will be helpful and efficient in certain situations where your communication with other people is blocked.

If you encounter a problem or need more help in the settings and configuration of WhatsApp Proxy, let us know in the comments section so that we can respond as soon as possible.

Thank you for reading this article to the end.

Leave a Reply

Your email address will not be published. Required fields are marked.

Andrew Publish in August 16, 2023 at 3:55 am

Do WhatsApp updates affect compatibility with WhatsApp Proxy configuration?

    Liosa F Publish in August 16, 2023 at 3:56 am

    Sometimes, an update might introduce changes that require adjustments to your WhatsApp proxy settings.