HandyCafe Docs
owner it-admin

Settings Overview

The Settings page is the central configuration hub for your HandyCafe server. All operational parameters for your internet cafe or gaming center are managed here, including pricing, client devices, staff, printers and the gateway connection.

Accessing Settings

Open the Settings page from the main navigation sidebar. The page displays a category list on the left and the active category's configuration panel on the right. General opens by default.

Settings Categories

The settings sidebar groups configuration into five groups. The order below matches the sidebar.

Venue

Category Description
General Country, language, font, currency and calendar preferences
View Default Computers and Consoles views, and which pages, title bar buttons, info cards and log tabs are visible, cafe-wide or per role
Staff Cashier accounts, roles and permissions, shifts and staff card sign-in

Revenue

Category Description
Pricing Hourly rates, fees, VAT, rounding and session presets. Pricing Plans and pricing groups are tabs on this page
Pricing Schedule Time-based pricing multipliers with a visual weekly grid
Loyalty Loyalty point earning and the tier thresholds that grant discounts
Subscriptions Member subscription plans and the unpaid grace period
Payment Methods The payment methods offered on the payment screen, plus the payment provider tabs (Ödeal, Checkbox, Stripe)

Campaigns, Suppliers and Inventory are no longer settings categories. Campaigns and packages moved to the Campaigns page in the main navigation. Suppliers, products, goods receipts and stock levels moved to the Stock page in the main navigation. The cafeteria settings are a tab on the Cloud page.

Client Devices & Access

Category Description
Clients Client device settings in 10 tabs: General, Registered Clients, Network, Content, Appearance, Idle Screen, Client Tasks, Client Security, Restrictions and Legacy Clients
Communication Local client chat, conversation permissions, voice messages and history retention
Consoles Console records plus the network power management block
Device Finder Scan the network for consoles, TVs and computers that still need setting up
Licenses The Steam account pool handed to stations on demand and the App Licenses tab
Zones Group PCs and consoles by the zone of the venue they sit in
Remote Management Remote desktop quality, capture and permission settings

Infrastructure & System

Category Description
Gateway The connection to the HandyCafe Gateway: address, password and gateway updates
Printers Printer inventory and role assignment for bills, kitchen and ticket receipts
Notifications & Sounds Notifications and sounds for cashier calls, orders and session events
File Sync File synchronization to push updates and files to client PCs
Folder Locations Where the database, working files, access logs and application logs are kept
Database Maintenance Backup, vacuum, integrity checks and scheduled maintenance
Migration Import data from an earlier HandyCafe installation or from other cafe software

Account

Category Description
Account Contact person, cafe, country, current plan, active Cloud and Cafeteria Add-ons, renewal state, device limits, Dashboard access, status refresh and account sign-out. See also HandyCafe Account
About Application versions, mobile application links, Dashboard access, website and documentation

Some categories and tabs appear only when the matching module or provider is available for the cafe. The Ödeal tab under Payment Methods, for example, appears only for cafes whose Cloud provider catalog lists it. See Payment Providers.

About

About is the last entry in the settings sidebar. It loads its information automatically when it opens.

  • Version: The Server row shows the version of this build. When the update catalog lists a newer server version, the row shows Update available and a Version X available notice with the new version number appears below the rows. The Client row shows the latest published client version. If the catalog cannot be reached it falls back to the server version and says Catalog unavailable. When a gateway connection with a password is saved, a Gateway row shows the version installed on the gateway, with Up to date, Update available, Installing or Not responding. The gateway itself is updated from its own card, see Gateway Updates. Check for updates runs the checks again.
  • Get the mobile apps: QR codes to scan with a phone. HandyCafe Manager is for owners and staff, HandyCafe Gamer is for your members.
  • Links: Open the Dashboard, the Website and the Documentation in your browser. The documentation opens in the current interface language.
  • Third-party data: Credits for the block lists used by the gateway web filter.

Saving and Canceling Changes

Global Save and Cancel buttons are displayed at the bottom of every settings panel.

Actions on the Account page take effect immediately. They do not use the global Save and Cancel buttons. The View page also saves each change as soon as you make it.

When your plan includes cloud backup, every save is also copied to HandyCafe Cloud. See Cloud Settings Sync.

  • Change detection -- The Save button is only enabled when you have made modifications to the current category. If no changes are detected, the button remains disabled.
  • Cancel -- Reverts all unsaved changes in the current category back to the last saved state.
  • Validation feedback -- If any field contains an invalid value (for example, a port number outside the allowed range), the Save button is disabled and the problematic field is highlighted with an error message.
  • Notification on save -- After a successful save, a confirmation notification appears briefly at the top of the panel. If the save fails (for example, due to a database write error), an error notification is shown instead.

Tips

  • Changes to the client network settings (ports and connection key, under Clients > Network) require a server restart. A changed connection key makes every client pair again.
  • Pricing and schedule changes take effect for new sessions immediately; active sessions continue under the pricing terms that were in place when they started, with new pricing segments created at schedule slot boundaries.
  • Client appearance and menu changes are pushed to all connected clients in real time. No manual sync is required.