HandyCafe Docs
owner it-admin

How to Manage Software Licenses

HandyCafe Server tracks software licenses across your client PCs. You define how many PCs may run each licensed application at the same time. The system records which PCs have checked out a license, notes when the limit is reached, and reclaims licenses from machines that stop responding. This guide covers adding licenses, monitoring usage, reaching the limit, the heartbeat timeout, revoking, expiration and a practical example.

App licenses live in Settings > Licenses, on the App Licenses tab. The Steam tab next to it holds game accounts, a separate feature.


How to Add a Software License

Adding a license tells the system about a piece of software, how many concurrent copies are allowed, and how to detect when it is running.

What you will need

  • HandyCafe Server running with admin access.
  • The exact process name of the application as it appears in Windows Task Manager (for example: photoshop.exe, steam.exe, chrome.exe).
  • The license key or serial number. The form does not save without one.
  • The number of concurrent seats your license agreement permits.

Steps

  1. Open Settings, choose Licenses and select the App Licenses tab.
  2. Click Add License. The Add New License dialog opens.
  3. Enter the Name. Use a clear, recognizable name such as "Adobe Photoshop" or "Steam Game Library."
  4. Enter the Provider name. For example: "Adobe", "Valve", "Microsoft." This helps you identify licenses by vendor.
  5. Enter the License Key or serial number. This field stores the key for your records. It is not transmitted to clients or used for activation.
  6. Enter a Type, such as "app" or "game". It is a label for your own reference and defaults to "game".
  7. Enter the Process Name exactly as it appears in Windows Task Manager. For example: photoshop.exe. This is how the system detects whether the application is running on a client PC. The match is case-insensitive. Fill in Executable Path (Optional) only if you need to tell apart two programs with the same process name.
  8. Set the Quantity to the total number of license seats you own. Set Concurrent Rights to the number of PCs that may run the application at the same time. In most cases these two numbers are the same. For example, if you purchased 5 concurrent licenses, set both to 5.
  9. Set the Heartbeat Timeout (sec). This is how long the system waits without hearing from a PC before it reclaims that PC's license. The default is 60 seconds. See the heartbeat section below.
  10. Optionally set an Expiry Date if your license has a renewal deadline. Click Save License.

Expected result

The license appears as a card in the License Pools list with its status, Quantity, Concurrent Rights, Active Sessions, Heartbeat Timeout, Expires At and Last Event. The system begins tracking the process on all connected client PCs. When a client runs the application, a license is checked out automatically.

Common mistakes

  • Entering the wrong process name. If the process name does not match what actually runs on the client, the system cannot detect the application. Open Task Manager on a client PC, launch the application, and note the exact process name shown in the Details tab.
  • Confusing the application display name with the process name. "Adobe Photoshop 2026" is the display name. The process name is photoshop.exe. Always use the process name.
  • Setting Concurrent Rights higher than the actual license agreement allows. The system counts against the number you enter, not against your contract.

How to Monitor Active License Usage

See how many PCs currently have a license checked out.

What you will need

  • At least one license configured in the system.
  • Client PCs running the licensed application.

Steps

  1. Open Settings > Licenses > App Licenses.
  2. Find the license card. Active Sessions shows how many PCs are running the application now.
  3. Compare it with Concurrent Rights. For example, with Concurrent Rights set to 5 and 3 PCs running the application, 2 seats are free.
  4. Last Event shows the most recent event for the license: Checkout, Heartbeat, Checkin, Timeout Reclaim, Manual Reclaim or Limit Reached.
  5. Click Refresh to reload the list.

Expected result

A current view of how many PCs are using each licensed application and how many seats remain.


When the License Limit Is Reached

When every seat is in use and another PC starts the application, the system does not check out a seat for it. It records a Limit Reached event for the license instead. The application is not closed on that PC. Use the event as your signal that the license pool is too small, or that a customer is running software beyond your agreement.

A seat becomes free again when a PC closes the application (Checkin) or stops reporting for longer than the heartbeat timeout (Timeout Reclaim).


How the Heartbeat Timeout Works

The heartbeat system ensures that licenses are not permanently locked by PCs that stop responding.

The license lifecycle

  1. Checkout: A client PC runs a monitored application. The system automatically checks out a license seat for that PC.
  2. Heartbeat: While the application is running, the client keeps reporting it to the server, confirming that the application is still active.
  3. Checkin: When the application closes, the next report no longer lists it and the license seat is released.
  4. Timeout Reclaim: If the server stops hearing from the PC for longer than the heartbeat timeout, it assumes the application is no longer running (the PC may have crashed, lost connectivity, or been shut down). The server reclaims the license seat automatically.

Changing the timeout

  1. Open Settings > Licenses > App Licenses and click Edit on the license card.
  2. Change Heartbeat Timeout (sec).
  3. Set a value appropriate for your environment:
    • 60 seconds is the default and frees a seat quickly after a crash.
    • 120 to 300 seconds suits networks with occasional instability, where you want to avoid reclaiming a seat from a PC that is still running the application.
  4. Click Update License.

Expected result

Licenses are automatically reclaimed from unresponsive PCs after the heartbeat timeout expires. This prevents "ghost checkouts" from permanently consuming license seats.

Common mistakes

  • Setting the timeout too short. Brief network interruptions or high server load can delay a report. A very short timeout can reclaim a license from a PC that is still running the application.
  • Setting the timeout too long (over 15 minutes). A crashed PC holds its license for the whole timeout, keeping the seat from other customers.

How to Revoke or Delete a License

  • Revoke on the license card stops tracking the license. Its status changes to Revoked and no new checkouts are made for it. Use it when a license is no longer valid but you want to keep the record.
  • Delete removes the license record completely.

How to Track License Expiration

What you will need

  • The renewal date for each of your software licenses.

Steps

  1. Open Settings > Licenses > App Licenses and click Edit on the license card.
  2. Set the Expiry Date to the date your license agreement expires or must be renewed.
  3. Click Update License.
  4. After that date the system stops checking out seats for the license. The status badge does not change on its own. Read the date under Expires At.
  5. When a license expires, decide whether to renew it with the vendor and update the expiry date, or delete the license if you are not renewing.

Expected result

Each card shows its expiry under Expires At, or No expiry. A license past its expiry date is no longer tracked. You do not keep counting software you are no longer licensed for.

Common mistakes

  • Not setting an expiry date at all. The card then shows No expiry and nothing tells you when the license lapses.
  • Renewing the license with the vendor but forgetting to update the date in HandyCafe. Seats are no longer tracked until you do.

Example: Managing 10 Concurrent Steam Game Licenses Across 30 PCs

This example illustrates a typical setup for a gaming cafe.

Scenario

You have 30 client PCs in your cafe. You purchased a commercial Steam site license that allows 10 concurrent users.

Setup

  1. Open Settings > Licenses > App Licenses and click Add License.
  2. Enter the name: "Steam Game Library."
  3. Enter the provider: "Valve."
  4. Enter your Steam site license key.
  5. Enter the type: "game."
  6. Set process name to steam.exe.
  7. Set Quantity to 10 and Concurrent Rights to 10.
  8. Leave Heartbeat Timeout (sec) at 60.
  9. Set the expiry date to your license renewal date.
  10. Click Save License.

How it works in practice

  • The first 10 customers who launch Steam on their PCs each check out one license seat. Active Sessions shows 10.
  • Customer number 11 launches Steam. No seat is checked out and the card records Limit Reached.
  • Customer 3 finishes their session and closes Steam. The system checks in the license, freeing one seat.
  • If PC-07 crashes while running Steam, it stops reporting. After 60 seconds, the server reclaims that seat. It is now available for another customer.

Monitoring

Check the App Licenses tab periodically. If Limit Reached keeps appearing during peak hours, consider purchasing additional concurrent licenses. If Active Sessions rarely comes close to Concurrent Rights, you may be over-licensed.