HAProxy API Socket Unreachable – Let's Encrypt SSL Issuance Fails

Open
#5,690 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
35/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
python

Research direction

Start by finding where the 'API socket is not reachable' error is raised in the HAProxy/ACME handling code, then check how the HAProxy config is rendered and applied and where its runtime API socket path is set. Reproduce by applying configs on a fresh 14.5.0b0 install and confirming whether the socket file exists and is writable by the panel process before the ACME map is loaded. Done means a direct-connection domain obtains a Let's Encrypt certificate without the socket error, and the reason the socket was missing is documented.

Written by the indexing model from the issue text.

Description

Bug/Feature:

Description: Let's Encrypt SSL certificate issuance fails due to an unreachable HAProxy API socket.

Details:

Hiddify Version: 14.5.0b0
Python Version: 3.13.17 (main, Oct 21 2026, 17:49:22) [Clang 23.1.3]
OS: Linux-6.8.0-147-generic-x86_64-with-glibc2.39
User Agent: Unknown

Problem Description:

Let's Encrypt fails to issue SSL certificates, even for domains configured for direct connections (without CDN).

The following error is displayed:

تا صدور گواهی واقعی، از گواهی خودامضا استفاده می‌شود.

letsencrypt: IssueError: HAProxy does not answer ACME challenges: its API socket is not reachable (apply the configs so HAProxy gets the ACME map)

The system also displays the following possible causes:

  • The domain must point to this server (or the CDN in front of it).
  • Port 80 must be accessible from the internet.
  • Let's Encrypt may temporarily reject requests if too many attempts are made within a short period.

Steps Already Taken:

  • Applied the configuration again.
  • Reinstalled Hiddify.
  • Retried SSL certificate issuance.
  • Tested with domains configured for direct connections (without CDN).

Expected Result:
Let's Encrypt should successfully issue SSL certificates for domains pointing directly to the server.

Actual Result:
Certificate issuance consistently fails with the HAProxy API socket error, and the system continues using a self-signed certificate.

Additional Information:
The issue persists despite reapplying configurations and reinstalling Hiddify. It appears to be related to HAProxy's API socket accessibility or ACME configuration rather than domain DNS or CDN settings.

Dominant language
Python
Stars
9.5k
Forks
1.1k
Avg merge
1d 2h
Merged PRs (30d)
9

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from hiddify/Hiddify-Manager

All issues in hiddify/Hiddify-Manager

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.