October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk5 min

How to Fix Refused Connections with ChromeDriver, Capybara, and Docker Compose

Find whether Capybara cannot reach ChromeDriver or Chrome cannot reach the app, then fix the Compose address, port, network, or driver configuration.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A “connection refused” error means the client reached an address where no process accepted the connection—or it tried the wrong address or port. First identify whether the refused connection is from Capybara to ChromeDriver or from Chrome to the application under test. Those are separate network links, and the fix depends on which one failed.

Identify which connection is refused

Read the full error and record the refused hostname, port, and caller. A Capybara/Ruby process may be trying to reach a WebDriver endpoint; after that, the browser may independently try to load your application. Do not change both endpoints at once: isolate the failing link first.

As an Amazon Associate I earn from qualifying purchases.

  • WebDriver endpoint: the test process cannot connect to ChromeDriver or Selenium.
  • Application URL: the browser cannot connect to the app it is meant to test.

The available details do not specify your service names, port mappings, process placement, or refused URL, so there is no single safe setting to prescribe. Use the hostname and port from your actual error in the checks below.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Fix the address for your Docker Compose layout

Compose containers on the same network can discover each other by service name. Docker recommends service names rather than container IP addresses, which can change when a container is recreated. A container-to-container connection uses the destination container’s listening port; a published host port is for access from outside the Compose network. See Docker’s Networking in Compose.

#1 Best Overall
OIKWAN USB Console Cable,USB to RJ45 Console Cable for Cisco Routers/AP Router/Switch Windows, Mac, Linux(1.8m,Blue)
  • ❤Console cable❤ :6FT-USB-RS232-RJ45 console cable .It's used for debugging and configuring network equipment ❤!!Please NOTE❤ this is USB to RJ45 CONSOLE CABLE ,Not ETHERNET !!!It is 8p8c!! Look carefully of the Pin is match with your device. Before ordering , please confirm it is you need. After receiving ,please read user manual /instruction at first . Customer service always online.
  • ❤Works for console port❤this USB to rj45 console cable Replaces COM port RS232 (DB-25/DB-9) serial port perfectly, connects to any laptop/PC's USB port directly to a console port like a charm. No more RS232 Female and male adapters。32 and 64 bit operating systems are both support.except Chrome OS
  • ❤Essential tools for network engineers❤The Cisoc Console Cable It's designed for that a PC or laptop‘s USB port connect to the console port with their Cisco modem, router, firewall, switch or other Serial based Cisco device. Cisco,Juniper,NETGEAR,Ubiquity,LINKSYS,TP-Link ,huawei, H3C, HP, 3com compatibly.
  • ❤The pinout names❤Cisco usb console cable USB2.0 (1.1 compatible); CONSOLE's DTE Pinouts: RTS(1), DTR(2), TXD (3), GND(4), GND(5), RXD (6), DSR(7), CTS(8); the RJ45 pinout names is 1-CTS, 2-DSR, 3-RXD, 4-GND, 5-GND, 6-TXD, 7-DTR, 8-RTS. Cable length 1.8m/6ft, Maximum RS232 speed 500kbaud
  • ❤LIFETIME CUSTOMER SUPPORT❤beside get 1pack *6ft cisco usb to console,you also back with 180-day no reason free return and refund and 24-hour online service.

Test and ChromeDriver share one container

Loopback, such as 127.0.0.1 or localhost, may be correct when the client and server share a network namespace. Google’s standalone ChromeDriver example uses 127.0.0.1:9515 for a single-host setup; that does not make it the right address when ChromeDriver is in a separate container. See ChromeDriver: Getting started.

ChromeDriver or the app runs in another Compose service

Use the destination service’s Compose name and its container port, and make sure the caller and destination share a network. For example, if the service is named chromedriver and its process listens on port 9515, the address from another service is typically http://chromedriver:9515—provided that is the actual listener and both services share a network. Do not substitute a host-published port or a remembered container IP without confirming the setup.

Rank #2
OIKWAN USB to RS232, USB Serial Adapter with FTDI Chipset,USB 2.0 to Male DB9 Serial Cable for Windows 11,10, 8, 7, Vista, XP, 2000, Linux and Mac OS(6ft)…
  • !!Please NOTE: this is MALE RS232 to DB9 SERIAL CABLE ,Not VGA!!!It is 9 pin, NOT 15 pin!! Look carefully of the Pin is match with your device. Before ordering , please confirm the interface gender is waht you need. After receiving ,please read user manual /instruction at first and download the Driver at first from FT232 Official website or Cisco website . Customer service always online.
  • Wide range of applications: USB to RS232 DB9 male serial adapter can work with your Windows (10 / 8.1 / 8 / 7 / Vista / XP), MAC or Linux system and other platforms. USB adapter is designed to connect to serial devices, such as serial modem with DB9, ISDN terminal adapter, digital camera, label writer, palm computer, barcode scanner, PDA, cash register, CNC, PLC controller, tax printer, POS, bar code scanner, label printer, etc
  • High quality: ftdi usb serial,the latest ftdi chip set ensures more reliable and faster operation. USB 2.0 to RS232 male DB9 console cable will support 1Mbps date transfer rate.
  • Most convenient: rs232 to usb simple installation, plug and play, COM port creation, baud rate can be changed to the required settings. USB power supply - no external power supply required.
  • Exquisite design: usb-to-serial,Gold Plated USB RS232 connector and PVC cable ensure high performance and extra durability. Powered by USB port, this USB to DB9 series RS232 adapter cable is designed to fit easily into your handbag.

Apply the same rule to the app URL loaded by Chrome: use an address Chrome can resolve and reach from its own container, not an address that works only from the host machine.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Check network membership, name resolution, and reachability

  1. Confirm the services are running: run docker compose ps and inspect the relevant service logs with docker compose logs <service-name>.
  2. Inspect network membership: identify the Compose network, then run docker network inspect <network-name>. Confirm the calling and target containers are attached to the same network.
  3. Test from the caller’s container: use docker compose exec <calling-service> <available-network-check-command> <target-service-name> <container-port>. Use a diagnostic command installed in that image; minimal images may not include tools such as curl or nc. Testing from the host alone does not establish that the caller container can resolve or reach the target.
  4. Verify the listener: check the target service’s logs and process configuration to confirm ChromeDriver or the application is running and listening on the expected interface and port before the client connects.

Docker documents docker network inspect and docker compose exec as tools for checking network configuration and connectivity. See Docker’s Compose networking guidance.

Rank #3
DSD TECH SH-U09C2 USB to TTL Adapter Built-in FTDI FT232RL IC for Debugging and Programming
  • FTDI FT232RL IC:Built-in original FTDI FT232RL IC. Supports 5V, 3.3V and 1.8V Logic TTL levels,You can switch Logic levels by jumper
  • Protective case: Come with a transparent protective casing, this transparent protective casing to effectively prevent static interference from the hand and prevent unintentional short circuit
  • Application:Support EEPROM, Vendor ID re-write, unbrick routers ,program ESP8266 module, interface to GPS modules, flash firmware on hard drive, update transmitter, interface to set top box and other compatible UART interface devices
  • Compatibility: This USB to TTL adapter is compatible with Windows 7, 8, 10 and various Linux OS and Mac OS
  • Customer Support: DSD TECH provides permanent technical support and 1 year product replacement service for this USB to TTL Adapter.

Choose a Capybara driver that matches the test

Driver approach Use it when What it means for this error
RackTest The test does not need JavaScript or a real browser. It does not start a browser or execute JavaScript, so it does not solve a Selenium/ChromeDriver connectivity issue.
Selenium-backed Chrome The test exercises browser behavior or JavaScript. Configure the driver for where Chrome and ChromeDriver run in your CI or Compose environment; check the WebDriver and app endpoints separately.

Capybara documents RackTest’s JavaScript limitation and its Selenium integration in its driver documentation. Do not switch to RackTest as a workaround if the test requires browser JavaScript.

Keep ChromeDriver access restricted

ChromeDriver allows local connections by default. If a separate service must connect remotely, configure allowed IPs for the intended clients and protect ChromeDriver and Selenium ports. Do not expose an unrestricted automation endpoint just to get past an address error. See ChromeDriver security considerations.

Rank #4
6Ft Long Cable USB 2.0 Type-A to Type-B High Speed Cord for Audio Interface, Midi Keyboard, USB Microphone, Mixer, Speaker, Monitor, Instrument, Strobe Light System Laptop Mac PC
  • FEATURES / POWER SPECS : Extra Long 6 Feet USB 2.0 Type-A Male to Type-B Male Connection Cable / High-Speed Transfer Rates up to 480Mbps 28AWG/2C+26AWG/2C with Error-Free Performance
  • COMPATIBILITY: Ideal for connecting your Yamaha Digital Piano, Roland Music Workstation, Donner DEP 10 20 45 DDP-80 88 Key Digital Pianos, Alesis, Korg, Casio Keyboard, AKAI Professional, Arturia KeyLab MiniLab, Midiplus, Nektar Impact, Novation, M-Audio MIDI Controller, Native Drum Controller, Pioneer, Hercules DJControl Inpulse, Numark DJ Mixer, Behringer U-Phoria, PreSonus AudioBox Audio Interface, Microphone, Studio Equipment to a Laptop, Computer (Mac PC) and other devices with a USB-B port
  • Also is a good USB Type B replacement cord for devices like Printer, Scanner, Fax, Hard Drive Disk, Server, Keyboard, DAC, Development board, UPS, Digital Camera, Arduino, Silhouette Cameo Cutting Tool Machine, Blue, Brother, Canon i-SENSYS PIXMA SELPHY, CyberPower, Dell, Epson Artisan Expression Home Premium Stylus WorkForce, Fujitsu, HP Deskjet ENVY LaserJet OfficeJet PhotoSmart, IOGEAR, Lexmark, Panasonic, Snowball mic
  • SAFETY: Pwr+ cables manufactured with the highest quality materials. CE/FCC/RoHS certified.
  • WARRANTY: 30 Days Refund - 24 Months Exchange. PWR+ is WA, USA based company. We are friendly Customer Support Experts
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot by symptom

  • The error names localhost or 127.0.0.1: determine whether the client and destination actually share a network namespace. If they are separate services, use the destination’s service name on their shared Compose network.
  • The hostname resolves, but the connection is refused: confirm the target process is running, listening on the port you configured, and ready before the test connects. A service name resolving correctly does not prove that an application listener is available.
  • The host can reach a published port, but another container cannot: configure the client to use the target’s container port and service name for Compose-network traffic.
  • ChromeDriver starts, but the browser cannot load the app: inspect the application URL from Chrome’s container context. This is an app reachability problem, not necessarily a WebDriver endpoint problem.
  • The test expects JavaScript but uses RackTest: select a Selenium-backed Chrome driver and configure its endpoints for the container layout.
  • Remote access fails after adding restrictions: verify that the intended client address is allowed, while keeping the driver port protected.

Or skip the browser setup

If you need a screenshot rather than a browser-driven Capybara test, ScreenshotNeo provides a website screenshot API and MCP server. A single GET request can return an image or PDF. Its API accepts a URL directly:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

See the ScreenshotNeo API documentation for options. Before capture, it accepts cookie/consent banners like a visitor and removes supported consent platforms, newsletter popups, and chat widgets; each step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers report the page verdict and billing status. AI agents can use its MCP server tools to take screenshots, get page information, and capture PDFs. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000.

Sign up for ScreenshotNeo’s free plan.

Frequently Asked Questions

Does a refused connection tell me whether ChromeDriver or the app is broken?

No. Use the refused URL and identify which process made the request; Capybara-to-WebDriver and browser-to-app are separate connections.

Best Value
USB-CSD5 for KNX3-KAP2 servo USB Debugging Cable Data Cable Download Cable Programming Cable Dual chip Design Industrial Black 3 Meter
  • USB-CSD5 for KNX3-KAP2 servo USB debugging cable Data cable Download cable Programming cable Dual chip design Industrial Black 3 Meter

Should I use the Compose host port between containers?

Normally no. Containers on the shared Compose network connect to the destination service name and its container port; published host ports are for access from outside that network.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

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

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.