Client Installation
HandyCafe Client runs on each customer-facing PC in your internet cafe or gaming center. It connects to the HandyCafe Server over your local network and enforces session control, displays the app menu, and handles the idle screen.
Prerequisites
- HandyCafe Server is already installed and running on your management PC
- The client PC meets the system requirements
- The client PC is on the same LAN as the server
- You have administrator access on the client PC
Download
Download the latest version from the official HandyCafe website. On Windows, the same setup file installs either the server or the client.
Installation Steps
- Run the setup. Double-click the downloaded setup file.
- Choose the role. On the What will this PC be? screen, select Client. The client locks the desktop and connects to your server.
- Complete installation. Wait for the process to finish.
- Launch HandyCafe Client. The application starts automatically when Start it when setup is done is selected.
Silent Installation
For many PCs, run the setup from a command line or a deployment tool with /S /ROLE=client. The client is installed without any screens. A silent run without /ROLE installs nothing and exits with code 2.
Connecting to the Server
A new client opens the Connect this computer to your server screen.
Pair with a Code
- On the server, open the Connection Wizard from the Computers page or from Settings > Clients > Network. It shows a six-digit code.
- On the client, type the code into Pairing code and click Connect.
- The client finds the server, receives the connection key and shows Connected.
Codes expire after 30 minutes. Generate a new one on the server if the code is old. Code pairing works without typing an address.
If pairing does not succeed, the screen explains why. After a rejected code, no answer or a port error, the button changes to Try again.
- Enter all six digits of the code. The code is incomplete.
- A server answered but rejected this code. Check the digits on the server screen or generate a new code there. The code boxes are cleared.
- No server answered on this network. 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. The Cannot use a code? panel opens automatically the first time this happens.
- This computer could not open a network port for pairing. A firewall or security program on the client is most likely blocking it.
After Connected, select Continue to leave the screen.
Search or Enter the Address
If a code cannot be used, open Cannot use a code? under the pairing card.
- Search the network instead looks for the HandyCafe server on the local network. When it finds one, it shows the server address and Use this server. Otherwise it shows No server found on the network.
- Enter the address manually opens the Server IP Address, Server TCP Port and Connection Key fields and a Save button. The Connection Key field starts empty and must be identical to the key on the server. Use this server also saves the key typed here.
See Client Settings for all connection options, including Automatically find and connect.
Verifying the Connection
Once connected:
- The client appears on the server's Computers page as an idle PC
- The client shows the idle screen (lock screen) configured on the server
- The server can start sessions, take screenshots, and control the client
Client Naming
New clients are named automatically with a prefix and a number, such as PC #1 and PC #2. You can change the prefix and rename individual PCs in Settings > Clients > Registered Clients:
- Auto-naming: Set the Automatic Client Name Prefix. New PCs get the prefix plus the lowest unused number.
- Manual naming: Rename a PC in the list.
See Registered Clients.
Deploying to Multiple PCs
For large deployments:
- Install the client on one PC and configure it.
- Use disk imaging tools to clone the configured PC to other machines.
- Alternatively, run the setup silently with
/S /ROLE=clienton each PC and pair each one with the same code. - Use the File Sync feature to push files and configurations from the server.
Note: Each client is identified by its MAC address. If you clone PCs, ensure each has a unique MAC address (which is the case with physical hardware).
Troubleshooting Connection Issues
| Problem | Solution |
|---|---|
| Pairing code is rejected or no server answers | Check the digits on the server screen and generate a new code if it expired. Verify the server is running and both PCs are on the same network. |
| Client cannot find the server by search | Enter the server IP manually. Check that multicast traffic is not blocked. |
| Client connects then disconnects | Verify the connection key matches on both server and client. |
| Connection is slow or drops | Check network cables, switch ports, and bandwidth. |
| Firewall blocking connection | Add exceptions for HandyCafe on both server and client PCs. Open TCP 5001, 5002, 5003 and UDP 5004. Code pairing also needs UDP port 45998 on the server. |
Next Steps
- Configure Network Settings: Fine-tune ports and connection key
- Client Updates: How clients receive new versions
- Set Up Client Menu: Build the app launcher for customers
- Configure Idle Screen: Customize the lock screen