HandyCafe Docs
owner

How to Set Up Your Cafe from Scratch

This guide walks you through every step of a new HandyCafe installation for your internet cafe, gaming center, or esports arena. By the end you will have a working server, at least one connected client PC, configured pricing, and a completed test session with payment recorded in your reports.

What You Will Need

  • A Windows PC to act as your HandyCafe Server (Windows 10 or later, 4 GB RAM minimum).
  • At least one additional Windows PC to act as a client station.
  • A local network connecting all PCs (wired Ethernet recommended for reliability).
  • A HandyCafe account. You sign in with it during first setup. See HandyCafe Account.
  • Your desired hourly rate and currency decided in advance.

Phase 1: Install and Configure the Server

  1. Download the latest HandyCafe installer from your HandyCafe dashboard.
  2. Run the installer on the PC you have designated as the server. Choose the server installation and follow the on-screen prompts.
  3. Launch HandyCafe Server. The Sign in to activate screen appears first. Sign in with your HandyCafe account, either with email and password or with Sign in with HandyCafe in the browser.
  4. The First Setup wizard follows. On Create your admin account, enter a username and a strong password. You sign in to the server with this account and it has unrestricted access to every feature.
  5. If the cafe already has settings saved in the cloud, a Load settings from cloud step offers to restore them. See Cloud Settings Sync.
  6. On Admin account for client computers, set the account you will type on a client PC to unlock it. It is separate from the server login.
  7. The last step, Now install HandyCafe on one computer, shows a six-digit pairing code. Keep this screen open for Phase 4. To connect a computer later, select Skip for now.

Expected result: After setup you sign in with the new admin account. The server opens on the Monitoring page. See First Setup Wizard for each step in detail.


Phase 2: Configure Pricing

  1. Open Settings, then General. Check Local Currency Symbol and Currency Code. They are filled in from your country and can be changed here. All prices, transactions and reports use this currency.
  2. Open Settings, then Pricing. The Pricing tab opens with the Standard group selected in the Pricing Group combo.
  3. In the Computer row, enter your price per hour under Hourly rate. For example, enter 10.00 for ten units of your currency per hour.
  4. In the same row, set the Startup Fee. This is the minimum charge per session regardless of duration. Enter 0 if you do not want a minimum charge.
  5. In the Shared by all groups card, set Vat % (0 to 250). VAT is included in your prices, not added on top. Enter 0 if VAT does not apply.
  6. Set up the five quick-start presets. Turn on the switch on the presets card, choose Duration under Type and fill the five Values with minutes, for example 30, 60, 120, 180 and 300.
  7. Click Save to apply your pricing configuration.

Expected result: The five preset values appear as quick-select buttons when a cashier starts a session. See How to Configure Pricing for pricing groups, schedules and member rates.


Phase 3: Verify Network Settings

  1. While still in Settings, open Clients, then the Network tab.
  2. Under Ports, verify the TCP Port. The default is 5001. Change it only if another program on the server already uses that port.
  3. Under Client connections, note the Connection Key. Every client is paired with this key. A client paired with a code receives it automatically.
  4. Ensure the server PC's firewall allows inbound TCP connections on the configured ports. On Windows, HandyCafe typically adds these rules during installation. If you changed a port, add a new firewall rule manually.

Expected result: The Network tab shows the ports and the connection key. See Network Settings for the connection test and the other ports.


Phase 4: Deploy the First Client

  1. Download the HandyCafe installer from your dashboard.
  2. Install it on your first client PC and choose the client installation.
  3. Launch HandyCafe Client. It shows Connect this computer to your server.
  4. Enter the six-digit Pairing code shown on the server and select Connect. If the setup screen is closed, open Settings, Clients, Network on the server and select Connection Wizard to show a new code. Codes expire after 30 minutes.
  5. If a code cannot be used, select Search the network instead or Enter the address manually.
  6. Wait for the connection to establish. The client screen switches to the lock screen.

Expected result: On the server, the Computers page now shows one connected client in the idle state. The client PC shows the lock screen.

  1. The server names the client automatically. To rename it, open Settings, Clients, Registered Clients. See Registered Clients.

Phase 5: Run Your First Test Session

  1. On the server Computers page, start a session on the idle client.
  2. In the session dialog, choose a postpaid session. Leave the member field empty for a guest session.
  3. Confirm to start the session.

Expected result: The client card shows the session as running with a timer. On the client PC, the lock screen disappears and the Online Page desktop appears.

  1. Let the session run for at least 5 minutes so you can verify pricing calculations.
  2. Stop the session from the client card on the server.
  3. Review the cost breakdown dialog. It shows the duration, the hourly rate applied and the total charge.
  4. Select a payment method (Cash is the default).
  5. Confirm to close the session and record the payment.

Expected result: The client returns to the idle state. The client PC shows the lock screen again. A transaction is recorded in the system.


Phase 6: Verify in Reports

  1. Open the Reports page from the left sidebar.
  2. Confirm that today's report shows one session transaction.
  3. Verify the transaction amount matches the cost breakdown you saw when stopping the session.
  4. Check that the payment method column shows "Cash" (or whichever method you selected).

Expected result: The report lists one completed session with the correct amount and payment method. Your cafe is now operational.


Phase 7: Optional Next Steps

Once your basic setup is working, consider configuring these features:

  1. Add members. Open the Members page and select New member to create member accounts. Members can log in from client PCs.
  2. Set up products. Open the Stock page and switch to the Cafe Menu tab. Add food and drink items with prices so cashiers can create orders.
  3. Configure the client menu. Open Settings, Clients, then the Content tab. Add application categories and apps so customers see a launcher grid on the Online Page.
  4. Deploy additional clients. Install HandyCafe Client on every station PC in your cafe and pair each one with a code from the Connection Wizard.
  5. Create cashier accounts. Open Settings, then Staff. Add cashier accounts with appropriate roles so staff can log in and manage sessions. See How to Set Up Cashier Roles.
  6. Set up peak/off-peak pricing. Open Settings, then Pricing Schedule. Paint time-based multipliers to charge more during busy hours.
  7. Enable guest login requests (optional). Open Settings, then Clients. Turn on login requests so walk-in guests can ask you to open a PC from the idle screen.
  8. Coming from other cafe software. Cashiers, members, wallets, products and cash history can be imported from several other programs. See Migrating from Other Cafe Software.

Common Mistakes to Avoid

  • Skipping the firewall rule. If clients cannot connect, the most common cause is a Windows Firewall rule blocking the TCP port. Verify the rule exists before troubleshooting other issues.
  • Mismatched connection keys. A client connected manually must use exactly the key shown on the server. Pairing with a code avoids typos because the key is handed over automatically.
  • Setting hourly rate to 0. If you leave the hourly rate at zero, all postpaid sessions will be free. Always verify your pricing before going live.
  • Forgetting to save settings. Changes in the Settings page do not apply until you click Save. If settings seem unchanged after a restart, you likely forgot to save.
  • Running server and client on the same PC. While technically possible for testing, this is not recommended for production. The server PC should be a dedicated station.