Migration

In this release, NetVisor is migrating from username-based authentication to email-based authentication. This change aligns with modern authentication standards and prepares the system for future features like password reset flows and email notifications. In addition, OIDC is added as a supported auth method.

What's Changing

Your Username Becomes Your Email
During the migration, your username will be automatically converted to an email address using the following rules:
If your username contains an @ symbol:

It's already an email → kept as-is
Example: maya@example.com stays maya@example.com

If your username does NOT contain an @ symbol:

@example.com is appended to create an email
Example: maya_admin becomes maya_admin@example.com

Special character handling:

Leading/trailing underscores are removed
Example: maya becomes maya@example.com
Example: maya_user becomes maya_user@example.com (middle underscores preserved)

What You Need to Do

1. Check Your New Email Address
After the migration, view your email in the Account Settings modal.

Click Account in the sidebar
Your email is displayed under "User Information"

2. Update Your Email (Optional)
If you want to use a different email address:

Open Account Settings → Click Update under "Email & Password"
Enter your preferred email address
Click Save Changes

3. Login with Your New Email
From now on, use your email address (instead of username) when logging in.
Checking Your Email via Database
If you need to verify your migrated email before logging in, you can query the database directly:

docker exec -it netvisor-postgres psql -U postgres -d netvisor

-- View all user emails
SELECT id, email FROM users;

-- Find your specific user
SELECT id, email FROM users WHERE email LIKE '%yourname%';```