Skip to main content

Veeam SPC | Connection Refused Error (Port 1280)

Updated this week

Overview

When configuring the Liongard inspector for Veeam Service Provider Console (SPC), you might encounter a connection error similar to:
​

Axios Error: connect ECONNREFUSED <IP_ADDRESS>:1280

This typically indicates that the Liongard inspector is unable to reach port 1280 externally.

Why does this happen?

  • The Veeam SPC REST API listens internally on port 1280 (HTTP) and 1281 (HTTPS) by default.

  • Your firewall or reverse-proxy may expose the REST API externally via a standard port (443) instead of port 1280.

  • Attempting to access https://yourdomain.com:1280/api/v3 externally, when port 1280 is not exposed, results in a "connection refused" error.

Resolution

If you encounter this issue, follow these steps:

  1. Check External Connectivity

    • Verify if port 1280 is open externally using a tool like portchecker.co or using:
      ​

    Test-NetConnection yourdomain.com -Port 1280

  2. Use Standard HTTPS Port (Recommended)

    • Change the inspector URL to use HTTPS on the standard port 443 by removing the port from the URL:
      ​

    https://yourdomain.com/api/v3

    This approach is commonly used and recommended as it leverages existing firewall/reverse-proxy configurations.
    ​

  3. Adjust Firewall or Reverse-Proxy (Optional)

    • If you need to use port 1280 explicitly, configure your firewall or reverse-proxy to forward external traffic on a public-facing port (e.g., 443) internally to port 1280.

Did this answer your question?