First Setup Wizard
The First Setup Wizard appears after HandyCafe account activation when you launch HandyCafe Server for the first time. It creates the server administrator account, sets the admin account for client computers and helps you connect the first client PC.
What Happens on First Launch
HandyCafe first requires you to sign in with your HandyCafe account and activates the account license on the server. See HandyCafe Account. It then checks for a local Admin account. When no Admin exists, the setup wizard is displayed instead of the staff login screen. You cannot bypass this step. A local Admin account is required to use the software.
Wizard Steps
A stepper on the left shows where you are. The wizard has three or four steps:
| Step | What you do |
|---|---|
| Server login | Create your admin account for the server. |
| Cloud settings | Start from settings saved in the cloud. Shown only when this cafe already has saved settings. |
| Client admin | Set the lock screen admin account and the connection key for client computers. |
| Connect a computer | Pair your first client PC with a code. |
Step 1: Server Login
The Create your admin account screen has three fields:
- Username. Enter a username for the admin account. This is the name you will type when logging in.
- Password. Enter a strong password.
- Password (repeat). Enter the same password again to confirm.
Click Next. The account is created and you are signed in with it right away. The next steps need this session to save settings.
Validation Rules
- All three fields are required
- The password and repeat password must match exactly
- If a user with the entered username already exists, you will see an error
Step 2: Load Settings from Cloud
When you reinstall HandyCafe or move it to a new computer, the cafe may already have settings saved in the cloud. In that case the Load settings from cloud step appears after the admin account is created.
- The newest saved settings are selected. Pick another row for an older one, or choose Set everything up from scratch to use the defaults.
- Click Load settings, or click Skip to continue without loading anything.
The step is not shown when there are no saved settings or the cloud cannot be reached. You can also restore later from the Cloud page. See Cloud Settings Sync.
Step 3: Client Admin
The Admin account for client computers screen sets the account you type on a client computer to unlock it. It is separate from the server login you just created.
- Enter a Username and Password for the client admin account.
- Check the Connection Key. This is the shared key every client computer uses to authenticate to this server. It is delivered automatically when you pair a computer. When the key is weak, a warning offers Generate strong key.
- Click Done.
The Connection Wizard cannot connect a computer until this account is set. Click Skip for now to set it later.
Step 4: Connect a Computer
The wizard then shows a 6-digit code, the three steps for entering it on a client PC and a download link for the client installer. It also shows the manual connection details (server address, port, connection key) for typing in by hand.
Continue stays disabled until a computer connects or the pairing channel is blocked on this network. Use Skip for now to leave without connecting a computer yet, after confirming. You can always come back to this pairing screen later with the Connection Wizard button on the Computers page or in Settings > Clients > Network. See Network Settings.
After Setup
Once you finish the last step:
- The First Setup Wizard closes.
- The dashboard opens on the first sidebar page, already signed in as the new Admin. You do not need to sign in again.
- The Admin account has unrestricted access to all features and settings.
Important: Store your Admin credentials in a safe place. If you forget the Admin password, use Forgot admin password? on the staff login screen and approve the reset with the HandyCafe account that owns the cafe. See HandyCafe Account.
Admin vs Cashier Accounts
The account created during first setup is the administrator account. It has full access to all pages, settings, and operations without any restrictions.
You can create additional cashier accounts later in Settings > Staff with role-based permissions that limit what each staff member can access. See Cashier Roles for details.
Next Steps
- Configure Settings: Set up pricing, network, and other options
- Install Client PCs: Deploy clients on customer PCs
- Create Cashier Accounts: Add staff with limited permissions