Where to look for your Home Assistant username

Your Home Assistant username is stored in your user account settings, not in the app itself. The fastest way to find it is to log into your Home Assistant instance through a web browser, go to your profile, and look at the account details there. If you are already logged in on your phone or computer, you can pull up the settings without needing to remember the password.

Home Assistant keeps usernames separate from email addresses. You may have created a username when you first set up Home Assistant, or the system may have assigned one automatically. Either way, it lives in one place: your user profile inside the Home Assistant interface.

Key Takeaways

  • Your Home Assistant username appears in your profile settings under the user account section, accessible from any device where you are already logged in.
  • If you set up Home Assistant through the official app or web interface, your username was created during the initial setup process and has not changed since.
  • You can view your username without logging out or resetting anything — just navigate to settings and look at your account details.
  • If you cannot remember your username and are locked out, you will need to reset your password through the login screen to regain access.

Finding your username in the web interface

Open a web browser and go to your Home Assistant address — this is usually something like homeassistant.local:8123 or a URL your system administrator gave you. Log in with your password if you are not already logged in.

Once you are on the main Home Assistant screen, look for a user icon or profile menu, typically in the bottom left corner of the screen. Click it. You should see your username displayed in the menu that opens, along with options like "Profile" or "Settings." Click on your username or "Profile" to open your account details, where your username will be shown clearly at the top.

Finding your username in the Home Assistant mobile app

If you use the official Home Assistant app on your phone, tap the menu icon (three horizontal lines) at the bottom right of the screen. Scroll down and tap "Settings."

In Settings, look for a section labeled "Account" or your profile name at the top. Tap it. Your username will be displayed on this screen along with other account information. You do not need to log out or enter your password — the app shows this information to anyone currently logged in.

What to do if you cannot see your username

If you are logged in but your username is not visible in the profile section, your Home Assistant instance may be set up differently than the standard configuration. Some custom installations hide the username display or use a different account system.

In this case, contact the person who set up your Home Assistant system — they can tell you what your username is or show you where to find it. If you set it up yourself and cannot locate it, you can reset your password through the login screen, which will let you log back in and access your profile settings.

Usernames versus email addresses

Home Assistant treats usernames and email addresses as separate things. Your username is what you use to log in, while your email address is optional and used only for password recovery. You might have set up an account with the username "alex" and the email "alex@example.com," or you might have a username with no email address at all.

If you are trying to log in and you are not sure whether to use your username or email, try your username first. The login screen will tell you if it does not recognize what you entered.

If you are locked out of your account

If you cannot log in and do not remember your username, you have two options. First, try the password reset feature on the login screen — enter any email address associated with your account, and Home Assistant will send you a reset link. Once you reset your password and log back in, you can see your username in your profile.

If password reset does not work or you do not have access to the email you used, contact the administrator of your Home Assistant system. They can view all usernames in the system and either tell you yours or reset your account for you.

Frequently Asked Questions

Can I change my Home Assistant username?

Yes. Go to your profile settings, look for an "Edit" or "Change" option next to your username, and enter a new one. The system will ask you to confirm the change. You will then log in with the new username on your next session.

Is my Home Assistant username the same as my email?

No. Your username and email are separate. You may have set up an account with a username like "homeowner" and an email like "you@gmail.com." The username is what you type to log in; the email is optional and used only for account recovery.

What if I share Home Assistant with other people in my home?

Each person has their own username and account. When you look at your profile, you see only your own username. Other household members will see theirs when they log in and check their profiles. The system administrator can view all usernames but cannot see other people's passwords.

Does Home Assistant store my username in the app?

The app remembers that you are logged in, but it does not display your username on the main screen. You have to open Settings to see it. If you log out of the app, you will need to enter your username and password again to log back in.