Documentsconnectivity-needs-for-the-player-firewall

Connectivity needs for the player (firewall)

Your player only needs ports 80 and 443 open to pisignage.com, and WebSocket must be allowed.

PiSignage is built on Node.js and the Express framework. The player talks to the server through an HTML REST API. Real-time communication uses a WebSocket interface over the standard HTTP port, so if you use a firewall, please enable WebSocket. Progressive downloads and retry-after-fail downloads use wget.

What the player needs

  1. HTTP, port 80
  2. HTTPS, port 443
  3. WebSocket traffic over port 80 or 443
  4. Access to the server names pisignage.com or eu.pisignage.com

The player uses port 80 if it reaches the server over http and port 443 (the https default) if it uses https. WebSocket (which uses an HTTP v1.1 header) and wget run on the same ports.

The IP address behind pisignage.com changes, since the service sits behind an AWS load balancer. Create your firewall rules with the domain name and not an IP address.

If you run your own server, use its address instead. The open source server listens on port 3000, see How to change player settings for network and server.

  1. How does player communicate with server 
  2. How to troubleshoot network connectivity 
  3. How to set proxy parameter along with port number