Installation guide

This guide will help you install and configure the WebDebugX debugging tool on different operating systems. Follow the steps for your own operating system.

System requirements

Before installing, make sure your system meets the following requirements:

Operating system: Windows 10/11, macOS 10.15+, or Linux
Memory: at least 1 GB of RAM
Storage: at least 500 MB of free space
Network: a stable internet connection (for reaching WebDebugX services)

Windows installation

Go to the WebDebugX download page
Click Windows version to download the installer
Once downloaded, double-click the installer to run it
Follow the prompts in the installation wizard
When it finishes, start WebDebugX from the Start menu or the desktop shortcut

Tip: try to keep non-ASCII characters out of the installation path.

macOS installation

Go to the WebDebugX download page
Click macOS version to download the DMG
Once downloaded, double-click the DMG to open it
Drag the WebDebugX app into the Applications folder
On first run you may need to allow it under System Settings > Privacy & Security

Linux installation

Go to the WebDebugX download page
Click Linux version to download the package
Make the executables runnable:

# Add execute permission
chmod +x webdebugx
chmod +x webdebugx-web

# Run the application
./WebDebugX

Initial configuration

After installing, you need to set up the phone — enable the Web Inspector, or turn on USB debugging — before you can start using WebDebugX. See How to enable Web Inspector in Safari and Chrome for the exact steps.

Updating WebDebugX

WebDebugX releases updates regularly to fix bugs and add features. You can update in the following ways:

In the WebDebugX application, click Upgrade at the bottom, then download the new version and reinstall
When an update is available, the application shows a prompt at the bottom to download and install it

Next steps

Once installed, continue with the Quick start tutorial to learn the basics of WebDebugX.