Initial Setup Guide
Complete first-run configuration for your Hygate workspace.
Accessing the Setup Wizard
Navigate to /setup on your Hygate instance. This page is only accessible before an administrator account exists. Once you complete setup, the page redirects to login.
Step 1: Create Administrator Account
| Field | Description |
|---|---|
| Your admin email address. Used for login and 2FA. | |
| Password | A strong password (min. 8 characters). Store this securely. |
| Confirm Password | Re-enter your password to confirm. |
Step 2: Workspace Basics
| Field | Description |
|---|---|
| Company Name | Displayed on payment pages and emails. |
| Default Access Price | Default price in EUR for new doors. Can be overridden per door. |
| Default Access Duration | Default duration in minutes for new doors. Can be overridden per door. |
| Currency | All payments processed in this currency. EUR is the default and recommended. |
Step 3: Configure 2FA (Recommended)
Choose a two-factor authentication method:
| Method | Description | Recommended For |
|---|---|---|
| Email OTP | A 6-digit code is sent to your email on each login | Teams without smartphones |
| Authenticator App | Use Google Authenticator, Authy, or any TOTP app | Maximum security |
| Either method | Let users choose their preferred 2FA method | Mixed teams |
We strongly recommend enabling 2FA for administrator accounts, even in test environments.
Completing Setup
Click Complete Setup to create your account and access the dashboard.
You will be redirected to the login page. Enter your credentials to access the dashboard.
Post-Setup Checklist
After completing initial setup:
- Configure Stripe — Required for payments
- Configure TTLock — If using smart locks
- Configure Shelly — If using IoT devices
- Configure Email Provider — For 2FA delivery
- Add Locations — Create your physical spaces
- Add Doors — Connect your TTLock locks
- Add Devices — Connect your Shelly devices
- Invite Team Members — Add operators and admins
- Customize Branding — Add your logo and colors
- Test the Full Flow — Pay with a test card
Resetting the System
If you need to start fresh:
Warning: This permanently deletes all data.
- Delete the database and recreate it
- Delete the
prisma/migrationsfolder - Run
npx prisma migrate deploy - Navigate to
/setupto begin again
Contact your hosting provider for database reset procedures specific to your deployment.