---
actual_hours: null
assignees: []
created_at: '2025-08-21T18:26:40.910122'
dependencies: []
description: "The user is experiencing \"ERR_CONNECTION_REFUSED\" when trying to access\
  \ localhost:8765 for the claude-mpm dashboard. Need comprehensive diagnosis and\
  \ resolution.\n\n**Problem**: Browser shows \"localhost refused to connect\" when\
  \ accessing http://localhost:8765\n\n**Required Actions**:\n1. Check if Socket.IO\
  \ server process is running and listening on port 8765\n2. Verify dashboard web\
  \ server status and port configuration  \n3. Investigate any firewall or permission\
  \ issues blocking localhost connections\n4. Review server error logs for connection\
  \ failures or crashes\n5. Restart both Socket.IO backend and dashboard frontend\
  \ if needed\n6. Validate full accessibility of http://localhost:8765 in browser\n\
  \n**Context**: This appears to be a service availability issue where the expected\
  \ servers are not running or not properly listening on the expected port.\n\n**Success\
  \ Criteria**: User can successfully access the dashboard at http://localhost:8765\
  \ with both Socket.IO backend and dashboard frontend operational."
due_date: null
estimated_hours: null
id: TSK-0156
labels: []
metadata: {}
parent: null
priority: high
status: open
tags:
- ops
- networking
- server-diagnostics
- localhost
- socketio
- dashboard
title: 'Ops: Diagnose and Fix localhost:8765 Connection Refused Error'
updated_at: '2025-08-21T18:26:40.910122'
---

# Ops: Diagnose and Fix localhost:8765 Connection Refused Error

## Description
The user is experiencing "ERR_CONNECTION_REFUSED" when trying to access localhost:8765 for the claude-mpm dashboard. Need comprehensive diagnosis and resolution.

**Problem**: Browser shows "localhost refused to connect" when accessing http://localhost:8765

**Required Actions**:
1. Check if Socket.IO server process is running and listening on port 8765
2. Verify dashboard web server status and port configuration  
3. Investigate any firewall or permission issues blocking localhost connections
4. Review server error logs for connection failures or crashes
5. Restart both Socket.IO backend and dashboard frontend if needed
6. Validate full accessibility of http://localhost:8765 in browser

**Context**: This appears to be a service availability issue where the expected servers are not running or not properly listening on the expected port.

**Success Criteria**: User can successfully access the dashboard at http://localhost:8765 with both Socket.IO backend and dashboard frontend operational.

## Details
- **Status**: open
- **Priority**: high
- **Assignees**: None
- **Tags**: ops, networking, server-diagnostics, localhost, socketio, dashboard
- **Created**: 2025-08-21 18:26:40
- **Updated**: 2025-08-21 18:26:40

## Tasks
- [ ] Add task items here

## Notes
_Add any additional notes or context here._
