Back to Blog|TDS Compliance

How to Fix TRACES WebSocket eSigner Error: Guide (2026)

July 12, 202611 min readFaheem Ferdous

Tax deductors using the official TRACES Portal (TDS Reconciliation Analysis and Correction Enabling System at tdscpc.gov.in) must use a Digital Signature Certificate (DSC) to execute critical compliance tasks. These include signing correction returns, registering new tax accounts, approving online refund requests, or downloading consolidated files (Form 16, Form 16A, and Form 27D).

To bridge the physical USB DSC token with your browser interface, the TRACES portal utilizes a local background application called the eSigner Web Service. However, users frequently encounter connection errors, with the portal warning that it cannot establish a connection. Below is a detailed troubleshooting guide to configure Java, edit security exceptions, and resolve localhost port conflicts to fix the TRACES eSigner error.

Why the TRACES eSigner Fails to Connect

The connection fails because modern web browsers restrict local loopback requests sent from secure public HTTPS websites (like the government's TRACES portal) to your local machine (localhost). The primary causes are:

  • eSigner Web Service is Not Running: The TRACES eSigner utility must be actively running in your Windows system tray. If it is closed, the browser cannot find the listener port.
  • Java Runtime Environment (JRE) Security Blocks: eSigner runs on Java. If the Java security settings block self-signed localhost certificates, the local WebSocket connection cannot establish.
  • Browser SSL Blocks on localhost: Browsers like Chrome, Edge, and Firefox block connections to https://127.0.0.1:1585 because they treat the local WebSocket SSL certificate as invalid or self-signed.
  • Port 1585 Conflicts: If another local application (like the GST emSigner or a local database) is already listening on port 1585, the TRACES eSigner will fail to bind to that port.

Step-by-Step Troubleshooting Guide

Follow these solutions in order to resolve the TRACES eSigner connection error:

1. Download and Install the Latest eSigner Client

Older versions of the eSigner client fail to load on updated browsers. Go to the TRACES homepage, log in to your account, navigate to the Downloads tab, and click on Requested Downloads. Alternatively, find the "e-Signer Utility" link in the portal help section, download the latest setup file, and install it on your PC.

2. Configure Java Control Panel Security Exception List

Because the TRACES eSigner utility relies on Java, you must explicitly white-list the TRACES portal and local loopback address:

  1. Press the Windows Key, type Configure Java, and press Enter to launch the Java Control Panel.
  2. Navigate to the Security tab at the top.
  3. Click the Edit Site List... button near the bottom.
  4. Click Add and enter the following URLs:
    • https://127.0.0.1:1585
    • https://www.tdscpc.gov.in
    • https://contents.tdscpc.gov.in
  5. Click OK, then click Apply, and close the Java Control Panel. Restart your computer to ensure the Java environment updates.

3. Run eSigner Web Service as Administrator

Right-click on the eSigner Web Service shortcut on your desktop (or in your Programs list) and select Run as Administrator. Running it with admin privileges allows Java to bind to port 1585 and establish local socket listeners without being blocked by Windows User Account Control (UAC).

4. Bypass Browser SSL Warnings (Proceed to Unsafe)

Most connections fail because the browser blocks the WebSocket due to SSL certificate warnings. Follow these steps:

  1. Open a new browser tab and navigate to the local eSigner URL: https://127.0.0.1:1585.
  2. Chrome or Edge will display a warning: "Your connection is not private" or "The certificate is invalid."
  3. Click on Advanced (or Advanced Settings).
  4. Click the link that says "Proceed to 127.0.0.1 (unsafe)".
  5. You will see a blank page or a simple message confirming the eSigner service is running. This action tells your browser to trust the local connection. Return to the TRACES portal, refresh the page, and attempt to register/verify your DSC.

eSigner GST vs. TRACES: A Key Distinction

Many taxpayers confuse the GST portal's emSigner with the TRACES portal's eSigner Web Service. While both utilities serve the same purpose — connecting local USB DSC tokens to a web portal — they are distinct applications developed by different software vendors.

Running GST emSigner will not allow you to sign on the TRACES portal, and vice versa. Furthermore, since both programs may try to use the same default port (1585), running both simultaneously can create a port conflict. Always close the GST emSigner from your system tray before launching the TRACES eSigner Web Service.

Automate Purchase Invoice Entry with TrulyInvoice

Configuring government portal tools and utilities like Java and eSigner is a necessity for monthly and quarterly filings. However, these technical configurations do not address the manual workload of managing your daily accounting entries.

For TDS compliance, recording purchase bills accurately is vital to ensure that TDS under Section 194Q or 194C is deducted on time. If your accountants spend hours manually typing vendor invoices into Tally Prime, you risk delayed bookings, missed deductions, and subsequent late-deposit interest penalties.

TrulyInvoice (plans starting at ₹399/month) automates this workflow by extracting invoice details from vendor PDFs using layout-aware OCR. TrulyInvoice automatically maps and posts formatted F9 Purchase Vouchers directly into your Tally Prime company. This eliminates manual entry errors, ensures TDS ledgers are configured based on verified supplier GSTINs, and simplifies your quarterly Form 26Q reconciliations.

F
Faheem FerdousExpert Reviewer

Tax Lawyer & GST Compliance Expert

Last Verified: July 12, 2026
TallyPrime FY 2026-27 (v4.0+)
Ready to save time?

Stop Manual Voucher Entry.

TrulyInvoice automates your complete invoice workflow and syncs directly to Tally Prime.

No credit card · 14-day free trial

01

Upload Invoice

Drag & drop PDFs, scans, or photos.

02

AI Extraction

Line items, tax, and ledgers mapped.

03

1-Click Review

Verify extracted details on dashboard.

04

Direct Sync

Vouchers created instantly in Tally Prime.

Chat with us