bitlvl
EN

Port 2376 Docker API (TLS) · TCP

Docker Engine API over TLS with mutual authentication: the client certificate is the password.

Port2376
TransportTCP
ServiceDocker API (TLS)
CategoryInfrastructure
Rangeregistered (1024–49151)
EncryptedYes, always (TLS or equivalent)
ExposureInternet-facing only with authentication and care

What runs on port 2376

Docker Engine API over TLS with mutual authentication: the client certificate is the password. Used by Docker Machine, some CI systems and Portainer. Still equivalent to root on the host for anyone holding a valid client certificate, so protect the keys and restrict by source.

Software that uses it: Docker Engine (--tlsverify) · Portainer · CI runners

Should port 2376 be open?

Internet-facing only with authentication and care. It can be exposed when the service behind it is authenticated, rate-limited and kept up to date; most deployments are better off behind a VPN, an allow-list or a reverse proxy.

Check port 2376

# on the host: is anything listening, and which process?
ss -ltnp 'sport = :2376'
sudo lsof -i :2376

# from another machine: is it reachable?
nc -zv host 2376
nmap -p 2376 host
curl -v telnet://host:2376      # raw TCP connect test, Ctrl-C to leave

A port that answers from the internet when it should not is the finding; nmap from a machine outside your network (or a VPS) is the honest test, because scans from inside the LAN pass the firewall you are trying to verify.

Allow or block port 2376

# ufw (Ubuntu/Debian)
sudo ufw allow from 10.0.0.0/8 to any port 2376 proto tcp
sudo ufw deny 2376/tcp

# nftables
nft add rule inet filter input ip saddr 10.0.0.0/8 tcp dport 2376 accept
nft add rule inet filter input tcp dport 2376 drop

# iptables (legacy)
iptables -A INPUT -p tcp --dport 2376 -s 10.0.0.0/8 -j ACCEPT
iptables -A INPUT -p tcp --dport 2376 -j DROP

# firewalld
sudo firewall-cmd --permanent --add-rich-rule='rule family=ipv4 source address=10.0.0.0/8 port port=2376 protocol=tcp accept'

Replace 10.0.0.0/8 with the networks that need access. Allowing by source address is the rule that matters; "allow 2376" with no source is just "open".

Related ports

Part of the port number reference. Ports are 16-bit numbers; see also the subnet calculator and the packet decoder, which shows ports inside TCP and UDP headers.

Questions

Is port 2376 TCP or UDP?

TCP. Docker API (TLS) is a connection-oriented protocol; there is no UDP service on 2376 by default (a scanner reporting UDP 2376 open is usually seeing a filtered port).

Is port 2376 encrypted?

Yes, always (TLS or equivalent). The port number does not make it safe by itself: certificate validation, authentication and patching still decide.

How do I check whether port 2376 is open?

On the server, ss -ltnp (or -lunp for UDP) shows whether something listens on 2376 and which process. From another machine, nc -zv host 2376 or nmap -p 2376 host tests reachability. "Open" in a scan means something answered; a firewall usually makes the port filtered (no answer) rather than closed (RST).

Can Docker API (TLS) run on a different port?

Yes; the number is a convention, not a requirement. Changing it reduces log noise from scanners but does not add security, and every client, firewall rule and monitoring check then needs the new number. Keep the default unless you have a concrete reason.