Client Settings
The Client Settings screen is the local configuration panel on each client PC. It shows the server connection and lets an authenticated administrator pair the PC with the server, change the connection, end the current session or remove HandyCafe from the PC. Admin credentials remain server-managed.
Accessing the Settings Screen
The Settings screen is only available to an administrator. After an admin signs in on the client, the Settings screen is displayed in place of the normal customer desktop. Standard members and guests never see this screen. This keeps the local configuration restricted to staff.
The screen header shows the Settings title along with two actions, Exit Program and Logout, described at the end of this page.
Server Connection
The Server Connection section offers three ways to reach the server.
Connection problem card
When the client cannot reach the server, a card at the top of the section explains why. It shows the address and port that were tried, what went wrong, what to do and the number of failed attempts. A rejected key or a client that is too old shows the card after the first failure. Other problems show it after three failures in a row. A short server restart stays silent.
| Card title | What to do |
|---|---|
| Nothing is listening on that port | Start HandyCafe on the server computer, then pair again with a fresh code to pick up the correct port. |
| No answer from this address | Check the server address. If it is correct, a firewall may be dropping the traffic. |
| That address is not on this network | Pair again with a code. The server's address is found automatically. |
| The server rejected this computer's key | Pair again with a code. The correct key is fetched automatically. |
| This client is too old for the server | Install the current client from the address on the card, or select Open the download page. |
| The server closed the connection | Try again. If it keeps happening, pair with a fresh code. |
Select Try again now to retry at once. To pair again, use the code boxes under Pair with a code below.
Pair with a code
Pair with a code is the quickest way and needs no address. On HandyCafe Server, open Settings > Clients > Network and generate a pairing code in the Connection Wizard. See Network Settings.
- Enter the six digits in the code boxes.
- Select Connect. The client searches the local network for the server that issued the code.
- When it succeeds, the client says it is now paired with your cafe.
If a server answers but rejects the code, check the digits or generate a new code. Codes expire after 30 minutes. If no server answers, check that the server is running and showing a code, that both computers are on the same network, and that the server's firewall is not blocking HandyCafe.
Manual connection
Open Manual connection to see the connection fields.
- Automatically find and connect searches the local network for the HandyCafe server instead of using a fixed address. While it is on, the address and port fields are locked. Select Search Now to look for the server straight away. The client reports the server it found, or that no server was found.
- Server IP Address is the host name or IP address of the machine running the HandyCafe server.
- Server TCP Port is the TCP port the server listens on. The default value is 5001. The port must be between 1 and 65535. A value outside this range is rejected with a validation message.
- Connection Key must be identical to the Connection Key on the server. If they differ, there is no connection. The server shows its key in Settings > Clients > Network.
Select Save to store the connection settings. After saving, the client confirms that settings were saved and that a restart is required to apply connection changes.
Restore Defaults
Select Restore Defaults under Manual connection to reset the server host, port and Connection Key to their default values. The fields update immediately to reflect the restored configuration. A confirmation message is shown. Use this when a client has been misconfigured and you want a clean starting point before entering the correct values.
Admin Credentials
Admin credentials are managed on HandyCafe Server. During normal runtime sync, the server sends only an Argon2id one-way verifier to a connected client. The client keeps it in process memory for the current boot. No local admin credential file is created or trusted. Use the server to change the cafe admin credentials.
Disconnected Client Admin Access
An admin can still sign in on a client that starts while HandyCafe Server is unreachable. While connected, the client keeps a copy of the admin login that the server signs for that PC. When no server answers, the client checks the admin username and password against this copy. A copy that was edited by hand or signed for another PC is rejected. After you change the admin password on the server, the client replaces its copy at the next connection.
If the client has never received a copy or the password typed is wrong, the recovery flow below applies.
The client does not expose a password-recovery button, an offline recovery code, or local admin setup. Recovery starts automatically only after three rejected login attempts while the normal HandyCafe Server connection is unavailable. A connected client never enters this recovery flow.
The login screen locks while the client discovers HandyCafe Server through mDNS and waits for a decision. The server opens the Reconnect client prompt for an administrator. The prompt shows the reported client name and MAC address. Select Connect client only when you recognize the station. Reject closes only the current request. The client can request recovery again after three new rejected login attempts. Reject & block also suppresses new recovery requests from that MAC address. The block ends after 30 minutes or when HandyCafe Server restarts.
Approval sends the current TCP port, file port, connection key, admin username and one-way admin password verifier through the request's encrypted LAN response. The plaintext admin password is never included. The client applies the values in memory, attempts to persist the connection settings, opens admin access and immediately starts a normal server reconnect. A diskless or read-only client can complete the current recovery even when its local overlay cannot be written.
This path does not require an existing authenticated TCP connection or a client-side recovery secret. The client and server must still be running on the same reachable LAN so mDNS and the recovery UDP port can work.
On the server, this same approval queue is one of the three tabs in the Connection Wizard. See Network Settings.
Logout
Select Logout in the header to end the current admin session on this client. The client returns to its locked state, ready for the next login.
Exit Program
Select Exit Program in the header to close the HandyCafe client application. A confirmation dialog titled Exit HandyCafe asks you to confirm before the application exits. Choose the confirm action to quit, or cancel to stay in the client.
Uninstall
The Uninstall section at the bottom holds Uninstall HandyCafe. It removes the HandyCafe client, the watchdog and the updater service from this computer. The station is then no longer managed by the server.
- Select Uninstall HandyCafe.
- Confirm in the Uninstall HandyCafe dialog.
- Approve the Windows permission request.
Only an admin session can start it, and only on Windows. If Windows declines the permission request, nothing is removed.
To update the client rather than remove it, see Client Updates.