HandyCafe Docs
owner it-admin

First Setup Wizard

The First Setup Wizard appears after HandyCafe account activation when you launch HandyCafe Server for the first time. It creates the initial administrator account that gives you full access to all features.

What Happens on First Launch

HandyCafe first requires account registration or sign-in and activates the account license on the server. 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.

Creating the Admin Account

The wizard has three fields:

  1. Username. Enter a username for the admin account. This is the name you will type when logging in.
  2. Password. Enter a strong password.
  3. Repeat Password. Enter the same password again to confirm.

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

After Setup

Once you click Create:

  1. The admin account is saved to the database
  2. The First Setup Wizard closes
  3. The Admin or Cashier login screen appears
  4. Sign in with the new Admin credentials to open the dashboard
  5. The Admin account has unrestricted access to all features and settings

Important: Store your Admin credentials and license key in a safe place. If you forget the Admin password, use Forgot admin password? on the staff login screen and verify ownership with the activated license key.

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 with role-based permissions that limit what each staff member can access. See Cashier Roles for details.

Next Steps