Luminati Proxy Manager

Proxy Manager is a forward HTTP/HTTPS proxy designed to accelerate, compress, rotate, distribute, manage, monitor, report, log, and debug traffic to proxies globally. It is specifically designed to drive Bright Data residential IPs or Bright Data static IPs and requires a Bright Data account.

Key features include:

• Highly scalable architecture
• Connection pooling for faster response times
• Web interface for managing multiple configurations
• Statistics and reporting
• Automatic IP rotation every X requests
• Load balancing across multiple Super Proxies
• SSL analyzing (via self-signed certificate)
• SOCKSv5 proxy support

Proxy Manager includes a "dropin mode" designed to behave exactly like existing super-proxies. This allows for easy migration without needing to sign in via the administrative UI; instead, the proxy username and password are provided directly with each request.

• Enabled by default: Dropin mode is active upon startup.
• Dropin Port: The default port for dropin mode is 22225 (configurable via --dropin_port).
• Disabling Dropin Mode: To disable this mode and require UI authentication, use the --no-dropin flag.

proxy-manager --no-dropin

Depending on your workload, choose between minimal or recommended hardware specifications:

Minimal requirements:

• 2GB RAM
• 1 CPU
• 3GB HDD

Recommended requirements:

• 4GB RAM
• 2 CPUs
• 3GB SSD

The "dropin" mode is the default operating mode for Proxy Manager. It functions identically to a standard Super Proxy, allowing you to send requests without logging into the administrative UI because proxy credentials are provided automatically. This mode facilitates an easy transition from a standard Super Proxy to the Bright Data Proxy Manager.

To disable dropin mode, use the --no-dropin flag.

pmgr --no-dropin

To install the proxy manager on Linux or MacOS, follow these steps:

1. Ensure Node.js 24.13.0 is installed (using nvm is recommended).
2. Install the Bright Data proxy globally via npm using the following command:

sudo npm install -g luminati-io/luminati-proxy

To run the proxy manager in the background as a daemon, use the --daemon flag:

proxy-manager --daemon

To install a specific version, identify the desired version number from the releases page and use the following npm command:

sudo npm install -g @luminati-io/luminati-proxy@VERSION_NUMBER

sudo npm install -g @luminati-io/luminati-proxy@1.75.355

To persist configuration files (like .luminati.json) and logs when using Docker, use a named volume and mount it to the /root directory inside the container.

1. Create a volume:

   docker volume create lpm-vol

2. Locate the mountpoint using docker inspect lpm-vol.
3. Place your .luminati.json file into that mountpoint directory.
4. Run the container with the volume attached:

   docker run --rm --name 'lpm1' --mount source=lpm-vol,target=/root "luminati/luminati-proxy" proxy-manager

To install the proxy manager on Windows, download and run the official installer executable.

https://brightdata.com/static/lpm/luminati-proxy-manager-v1.644.172-setup.exe

The fastest way to install on Linux or MacOS is to run the automated setup script using wget or curl.

# Using wget
wget -qO- https://brightdata.com/static/lpm/luminati-proxy-latest-setup.sh | bash

# Or using curl
curl -L https://brightdata.com/static/lpm/luminati-proxy-latest-setup.sh | bash

To enable SSL analyzing for HTTPS requests, use the --ssl flag. Note that standard HTTPS requests can be made without this flag, but --ssl is required for specific SSL-related proxy features.

proxy-manager --ssl

After installing Proxy Manager, run the application for the first time to initialize it:

proxy-manager

Once running, access the administrative web interface at http://127.0.0.1:22999 to configure your proxies and set up credentials.