HandyCafe Docs
owner it-admin

First Setup Wizard

The First Setup Wizard appears automatically 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

When HandyCafe Server starts and no admin account exists, the setup wizard is displayed instead of the login screen. You cannot bypass this step. An 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. You are logged in automatically
  3. The main dashboard loads
  4. You have unrestricted access to all features and settings

Important: Store your admin credentials in a safe place. If you forget them, you may need to reset the database to regain access.

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