Skip to main content

Welcome to Health Manager

Health Manager uses a “First User Takeover” policy to simplify the initial setup process. When you access the application for the first time, the system automatically handles database setup and grants you administrative privileges.

Initial Setup Process

1

Access the Application

Navigate to your Health Manager installation URL in your web browser. The system will automatically detect that the database is empty.
2

Automatic Database Setup

Health Manager will automatically create all necessary database tables. You don’t need to run any manual migration commands.
The system handles database migrations automatically on first access, eliminating the need for command-line tools.
3

Register Your Account

You’ll be redirected to the registration page. Fill in your details:
  • Full name
  • Email address
  • Password
  • Username (optional at registration, but recommended)
The first user to register automatically becomes the system administrator.
4

Become Administrator

Once you complete registration, you are automatically assigned the administrator role. This gives you access to:
  • User management panel
  • Full system settings
  • Ability to manage other users

Setting Up Your Username

After your initial login, it’s important to set up your username (also called “Nick”) so other users can find you when they want to share data.
1

Navigate to Your Profile

Click on your profile icon or navigate to the Profile section.
2

Set Your Username

Enter a unique username that others can use to find you. This username is required for data sharing features.
Choose a username that’s easy to remember and share with family members or healthcare providers.

Understanding Your Role

As the first user, you have special privileges:
  • Administrator Access: Full control over user management and system settings
  • User Management: Ability to view and manage all registered users
  • System Configuration: Access to administrative panels
Only the first registered user receives automatic administrator privileges. All subsequent users will have standard user roles unless promoted by an administrator.

Next Steps

Now that your account is set up, you can:

Important Security Notes

Make sure to configure your email settings in the .env file to enable password recovery and notifications.
  • Keep your administrator credentials secure
  • Use a strong password
  • Configure email settings for password recovery
  • Only grant administrator access to trusted users

Build docs developers (and LLMs) love