HandyCafe Docs
owner it-admin

Server Installation

HandyCafe Server is the management application that runs on your main PC. It monitors and controls all client PCs and consoles in your internet cafe, gaming center, or esports arena.

Prerequisites

Before installing, verify:

  • Your PC meets the system requirements
  • You have administrator access on the PC
  • Your network is configured (all PCs on the same LAN)
  • Required ports are available: TCP 5001, 5002, 5003 and UDP 5004

Download

Download the latest version from the official HandyCafe website. On Windows, one setup file installs either the server or the client. On macOS and Linux, download the server package for your system.

Installation Steps

  1. Run the setup. Double-click the downloaded setup file.
  2. Choose the role. The What will this PC be? screen asks what to install. Select Server. Install the server on one PC only, usually the front desk PC.
  3. Start it when setup is done is selected by default. Clear it if you do not want the server to open right after installation.
  4. Complete installation. Wait for the process to finish.
  5. Launch HandyCafe Server. The application starts automatically or you can launch it from the Start menu.

HandyCafe needs 64-bit Windows 10 or later.

First Launch

When you launch HandyCafe Server for the first time, two one-time steps run in order.

  1. Sign in to activate. Sign in with your HandyCafe account, either with email and password or with Sign in with HandyCafe in the browser. Select Create one for free if you do not have an account yet. The server then activates the cafe license. See HandyCafe Account and Licensing.
  2. First Setup Wizard. Create the server admin account (Server login), optionally load settings saved in the cloud (Cloud settings), set the admin account for client computers (Client admin) and pair your first computer (Connect a computer).

Important: Store your admin credentials securely. This account has unrestricted access to all HandyCafe features.

After the wizard finishes, the main dashboard loads and you are signed in automatically.

See First Setup Wizard for details.

Post-Installation Verification

Verify your installation:

  1. Dashboard loads. You should see the main dashboard with the sidebar navigation.
  2. Note your server IP. Check your server PC's local IP address (e.g., 192.168.1.100). Client PCs need this only if pairing with a code and automatic discovery both fail.
  3. Check firewall. The installer attempts to add firewall rules automatically. If clients cannot connect later, verify that ports 5001-5004 are allowed.

Updates

HandyCafe keeps the server and the client PCs up to date. The server asks before it installs its own update.

Server updates. The server checks the update catalog when it starts and again every few minutes while it runs. When a newer version exists, the server downloads it in the background ahead of time. A HandyCafe Server update available dialog then shows the new version and its release notes, with View changes, Remind me later and Update now. The dialog appears once per run of the application. After Remind me later it does not come back until the server is restarted.

Nothing is installed until you select Update now. The server then installs the new version and restarts. On Windows the installer can raise the Windows administrator permission prompt. Settings > About also shows Update available next to the server version, see Settings.

During a free trial the server installs updates by itself while no customer session is active. The trial then runs on the current version. While a session is running it waits. If the Windows permission prompt is dismissed twice, it falls back to the normal dialog.

Client updates. The server offers new client versions to connected PCs over the local network. A PC receives the update only when no customer session is active and it is running an older version. You can also push an update package by hand from the Computers page. See Client Updates.

Next Steps