HandyCafe Docs
it-admin

Network Settings

Network Settings configure how client PCs reach the HandyCafe server: pairing, the connection key, the communication ports and the admin login handed to every client.

Open Settings, then Clients, then the Network tab. Network used to be a settings category of its own. It now sits next to the other client tabs. See Clients Settings.

The tab has three blocks: Client connections (the Connection Wizard, its daily reminder and the connection key), Ports (with the connection test) and Admin Login Details.

Ports

HandyCafe uses three separate ports for different types of communication. All port values must be in the range 1 to 65535 and must not conflict with each other or with other services running on the server.

TCP Port

  • Default: 5001
  • Purpose: Main command and response communication between the server and clients. All session control messages (start, stop, extend), status updates, menu pushes, and configuration sync travel over this port.
  • Protocol: TCP with binary encoding and cryptographic authentication.

File Port

  • Default: 5002
  • Purpose: File transfers between the server and clients. Used by the File Sync feature to push files (game updates, configuration files, software) from the server to client PCs.
  • Protocol: TCP-based chunked file transfer.

UDP Port

  • Default: 5004
  • Purpose: Screen streaming for the remote desktop feature. When an administrator views a client's screen from the server console, the video frames are transmitted over this port.
  • Protocol: UDP for low-latency, real-time streaming.

Connection Test

Below the ports, a connection test checks whether a client computer on this network can actually reach this server. Press Run the test (later Test again). Each check shows Open, Blocked, Uncertain or Not checked: the local network address, whether the command, file transfer and remote management ports are listening and reachable over the network, and the HandyCafe firewall rule.

On Windows, Open the ports adds an inbound firewall rule for HandyCafe after you approve the Windows prompt. Run the test again afterwards. On macOS and Linux HandyCafe does not change the firewall. Allow the ports yourself.

Admin Login Details

Admin Username and Admin Password are the credentials a cashier or owner types on a client PC to open that client's local admin panel. They are set in the Admin Login Details block of this tab, not on the General tab.

  • The password is stored encrypted on the server and is never kept in plain text.
  • Saving a change pushes the new value to every connected client immediately.
  • One pair covers all stations; there is no separate password per client.

Forgetting the client admin password

Forgetting it is not a lockout. It does not need a support request.

  1. Open Settings > Clients > Network on the server.
  2. Type a new Admin Password under Admin Login Details.
  3. Save. Connected clients accept the new password at once. You can sign in on the client straight away.

If the client is offline or has lost its connection settings, it cannot receive the pushed value. In that case attempt the admin login on that client three times. After the third rejection the client looks for the server over mDNS and sends a reconnect request, which you approve from Connection Wizard > Pending requests. See Client Settings for the full recovery flow.

The client admin password is not the same as your HandyCafe Server admin account. If you forget the account you sign in to the server with, use Forgot admin password? on the staff login screen and reset it with your HandyCafe account. See HandyCafe Account.

Connection Key

The connection key is a shared secret password used for cryptographic authentication. Every message between the server and a client is signed with this key to prevent unauthorized devices from joining the network.

  • Every client is paired with this key. The Connection Wizard and the pairing code hand it to each client. You do not type it on the clients yourself.
  • If you change the connection key on the server, all clients pair again. A client that still holds the old key fails to authenticate and does not appear on the Computers page until it is paired again.
  • Use a strong, unique key. Avoid default or easily guessable values.

Connection Wizard

Click Connection Wizard in the Client connections block to open a dialog for connecting client PCs without typing the server address or connection key by hand. The dialog has three tabs.

Found on the network

Lists stations that are announcing themselves on the local network but are not yet connected. Each row shows the hostname, MAC address, IP address, app version and why it is not connected (fresh install with no server address set, has settings but cannot reach this server or already registered under a saved name). A station without a saved name gets a yellow warning and shows the address it announced from. That address is the only thing confirming which physical machine sent the announcement.

Click Connect on a row to send this server's address and connection key to that station. The delivery is encrypted and arrives on the station's next announcement, usually within a few seconds. The announcement itself is informational only. It does not create a pending request and does not raise an alert.

A last scan timestamp and a Refresh button sit above the list. The list also polls automatically every few seconds.

Pending requests

The same approve, reject and block queue described in Client Settings for a client that lost its configuration and is asking to reconnect.

Pairing code

Generates a 6-digit code an administrator can enter on a client PC to connect it, together with the download link for the client installer and the manual connection details (server address, port, connection key) for typing in by hand. The code and the three onboarding steps are described in First Setup Wizard.

Opening the Wizard from the Main Screen

A button with a badge appears in the Computers page toolbar whenever there is a pending reconnect request or a station announcing itself on the network. Clicking it opens the pending request queue if a request exists. Otherwise it opens the Connection Wizard on the Found on the network tab. The button can be hidden under Settings > View, Visibility tab, with Connection wizard button.

Daily Reminder

If no computer has been connected yet, HandyCafe opens the Connection Wizard automatically once a day as a reminder. The reminder dialog has a Do not show again checkbox next to the Close button, visible only when the dialog opened on its own. It is hidden when you opened the wizard yourself, since there is nothing to dismiss in that case.

Turning the reminder off is permanent until you turn it back on. Use the toggle labeled If no computer is connected, open the Connection Wizard once a day on this tab to re-enable it.

Important Notes

Changing ports or the connection key requires action on both sides:

  1. Update the values on the server's Network tab and save.
  2. Restart the HandyCafe server application.
  3. Reconnect every client by pairing it again with the Connection Wizard or a pairing code. A client that was connected by hand needs the new values in its manual connection settings.
  4. Restart the client application on each PC.

Firewall rules: Ensure that your network firewall (both the server's OS firewall and any hardware firewalls) allows inbound and outbound traffic on all three configured ports. Blocked ports will prevent clients from connecting or streaming.

LAN requirement: The server and all client PCs must be on the same local area network (LAN). HandyCafe uses mDNS for client discovery, which operates within a single broadcast domain. Clients on different subnets or VLANs may not be discoverable without additional network configuration.