How to Set Up Proxies with Apify (Configuration Tutorial)

Web scraping without proxies is extremely risky as your true IP address is exposed. Sites can easily block your IP, slowing down your scraping efforts. Proxies are essential for successful large-scale web scraping while avoiding blocks and captchas.

Apify is a robust web scraping platform that works great alongside residential proxies. This guide will demonstrate integrating leading proxy services like BrightData, Smartproxy, Proxy Seller and Soax into Apify across Windows, macOS and Linux. With the correct setup, you can automate proxy rotation to maximize results.

Datacenter vs Residential Proxies

Before jumping into setup, it's important to understand the differences between datacenter and residential proxies:

  • Datacenter proxies come from large shared IP pools and are the cheapest option. They work well for basic scraping but are vulnerable to blocks.
  • Residential proxies are from real devices like homes and mobile phones. They mimic real users and avoid blocks. Ideal for social media, e-commerce, and travel scraping.

We recommend using residential proxies for Apify to conceal your identity and presence fully. The proxy rotation techniques below help maximize IP utilization.


Setting up Proxies on Windows

Follow these steps to configure proxies in Apify on Windows:

  1. Open the Apify app and go to Settings > Proxy
  2. Under “Proxy source”, choose “Custom proxies”
  3. Enter your proxy credentials provided by your proxy provider:
    • Host: Proxy hostname
    • Port: Proxy port
    • Username: Your proxy username
    • Password: Your proxy password
  4. Select the proxy protocol – HTTP, SOCKS4 or SOCKS5
  5. Enable “Keep alive proxy” if you need sticky sessions
  6. Click “Test proxy” to verify the setup is working correctly
  7. Click “Save” to apply the proxy configuration

Some common issues on Windows include incorrect credentials or protocol, firewall blocking the proxies, and incorrect proxy port. Double check your proxy details and try toggling different protocols if you face any issues.

Here is an example proxy configuration in Apify on Windows using BrightData proxies:


Port: 8080

Username: bdf93j2k3

Password: px329dkPC

Protocol: HTTP

Setting up Proxies on macOS

The proxy setup process is very similar on macOS:

  1. Launch the Apify app and navigate to Settings > Proxy
  2. Choose “Custom proxies” under “Proxy source”
  3. Enter your proxy credentials:
    • Host: Proxy hostname
    • Port: Proxy port
    • Username: Your proxy username
    • Password: Your proxy password
  4. Pick the proxy protocol – HTTP, SOCKS4 or SOCKS5
  5. Toggle on “Keep alive proxy” if needed for sticky sessions
  6. Test the proxy to ensure connectivity
  7. Click “Save” to apply the proxy settings

Proxy connection issues on macOS can arise from incorrect credentials, protocols or blocked ports. Verify your proxy details and try using a different protocol to resolve problems.

Here is a sample proxy configuration on macOS with Smartproxy:


Port: 10000

Username: sp93j2k3

Password: px329dkPC

Protocol: SOCKS5

Setting up Proxies on Linux

Integrating proxies into Apify on Linux works similarly:

  1. Open Apify app and navigate to Settings > Proxy
  2. Under “Proxy source”, select “Custom proxies”
  3. Provide your proxy credentials:
    • Host: Proxy hostname
    • Port: Proxy port
    • Username: Your proxy username
    • Password: Your proxy password
  4. Choose the proxy protocol – HTTP, SOCKS4 or SOCKS5
  5. Check “Keep alive proxy” if required for sticky sessions
  6. Test the connection to verify it is working
  7. Click “Save” to apply the proxy configuration

Some common troubleshooting tips for Linux include double checking credentials, trying different protocols, allowing the proxy ports in your firewall and ensuring the Apify app has permissions.

Here is a sample proxy integration on Linux using Soax proxies:


Port: 2080

Username: soax93j2k3

Password: px329dkPC

Protocol: SOCKS4

Advanced Proxy Techniques

Automating Proxy Rotation

To maximize IP usage and avoid blocks, automate proxy rotation in your Apify scripts:

// Load proxy list 
const proxyUrls = await Apify.getValue('PROXY_URLS');

// Rotate proxy randomly
const proxyUrl = proxyUrls[Math.floor(Math.random() * proxyUrls.length)];

// Apply new proxy
await Apify.setProxy({ proxyUrl });

Use a proxy manager API to dynamically generate the proxyUrls list.

Debugging proxies

Enable debug logs to diagnose proxy issues:

// Enable debug log
await Apify.setValue('PROXY_DEBUG', true)

// Print debug output
const { defaultLog } = Apify.utils.log;

Inspect the logs to see negotiation failures, timeouts, malformed requests etc.

Custom Proxy Chains

For advanced users, chain multiple proxies together for added anonymity:

await Apify.setProxy({
  proxyUrls: [

The request will tunnel through each proxy server in sequence.

Troubleshooting Common Proxy Issues


Authentication errorDouble check username & password credentials
Incorrect protocolTry different proxy protocols like SOCKS5, HTTP, SOCKS4
Blocked IP addressContact your proxy provider for fresh IP allocation
Bandwidth exceededUpgrade to higher proxy plan with more bandwidth
High latencyReduce geographical distance to proxy servers
Blocked portsEnsure your firewall allows the proxy ports
Too many captchasReduce scraping frequency and enable proper proxy rotation

Be sure to monitor your proxy usage closely to avoid leaks or bans. Rotate IPs frequently and avoid blocks to maximize scraping uptime.

Platform Comparison

Windows, macOS and Linux have minor differences when setting up Apify proxies:

  • Setup: Windows and Linux offer granular proxy configuration while macOS uses system-wide proxy settings by default.
  • Protocols: Linux has the best SOCKS proxy support while macOS favors HTTP proxies.
  • Auth: macOS and Linux can store proxy credentials natively while Windows requires manual entry in Apify.
  • Defaults: Linux uses custom proxy settings as default while macOS uses system proxy config.
  • Automation: Linux and macOS have better scripting support for proxy management automation.
  • Permissions: Linux needs explicit firewall access for proxy ports.

Overall, the setup steps are very similar – enter credentials, test connectivity, choose protocol and save config. Windows and Linux offer more advanced customization options.


This guide covered integrating leading residential proxy services into Apify web scraper on various operating systems. With the correct credentials, proxy rotation is possible to avoid blocks and maximize scraping results. Be sure to monitor your proxy usage and IP activity closely to optimize performance. Proper proxy integration helps scale successful Apify scraping jobs.

John Rooney

John Rooney

John Watson Rooney, a self-taught Python developer and content creator with a focus on web scraping, APIs, and automation. I love sharing my knowledge and expertise through my YouTube channel, My channel caters to all levels of developers, from beginners looking to get started in web scraping to experienced programmers seeking to advance their skills with modern techniques. I have worked in the e-commerce sector for many years, gaining extensive real-world experience in data handling, API integrations, and project management. I am passionate about teaching others and simplifying complex concepts to make them more accessible to a wider audience. In addition to my YouTube channel, I also maintain a personal website where I share my coding projects and other related content.

We will be happy to hear your thoughts

      Leave a reply

      Compare items
      • Total (0)