Document FRITZ!Powerline username behavior#44808
Open
iluebbe wants to merge 2 commits intohome-assistant:currentfrom
Open
Document FRITZ!Powerline username behavior#44808iluebbe wants to merge 2 commits intohome-assistant:currentfrom
iluebbe wants to merge 2 commits intohome-assistant:currentfrom
Conversation
home-assistant
Bot
added
has-parent
✅ Deploy Preview for home-assistant-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the FRITZ!Box Tools integration documentation to clarify credential behavior when setting up FRITZ!Powerline devices, reducing confusion during SSDP auto-discovery and config flow setup.
Changes:
- Added a note under the “Username” section explaining that FRITZ!Powerline devices ignore the username and validate only the password.
| {% endnote %} | ||
|
|
||
| {% note %} | ||
| FRITZ!Powerline devices ignore the username — only the password is validated. Enter any value in the username field. |
There was a problem hiding this comment.
In this note, consider referencing the actual UI field labels as Username/Password (UI strings are typically bolded in these docs) and avoid the generic “username field” phrasing. This also makes it clearer that only the Password value is checked for FRITZ!Powerline devices.
Suggested change
| FRITZ!Powerline devices ignore the username — only the password is validated. Enter any value in the username field. | |
| FRITZ!Powerline devices do not validate the **Username** value. Only the **Password** value is checked, so you can enter any value in **Username**. |
chemelli74
reviewed
Apr 16, 2026
| If you still want to use the predefined user, please note that as of FRITZ!OS 7.24, the FRITZ!Box creates a random username for the admin user if you didn't set one yourself. This can be found after logging into the FRITZ!Box and visiting **System** > **FRITZ!Box Users** > **Users**. The username starts with `fritz` followed by four random numbers. Under properties on the right it says `created automatically`. Before FRITZ!OS 7.24, the default username was `admin`. | ||
| {% endnote %} | ||
|
|
||
| {% note %} |
Contributor
There was a problem hiding this comment.
I think it's better to add a paragraph to the previous note instead of creating a new one
chemelli74
previously approved these changes
Apr 17, 2026
mib1185
requested review from
a team,
CoMPaTech,
Shulyaka,
allenporter,
arturpragacz,
elupus,
epenet,
erwindouna,
fabaff,
frenck,
klaasnicolaas,
raman325 and
zxdavb
as code owners
home-assistant
Bot
added
current
home-assistant
Bot
removed
needs-rebase
mib1185
removed request for
a team,
CoMPaTech,
Shulyaka,
allenporter,
arturpragacz,
elupus,
epenet,
erwindouna,
fabaff,
frenck,
klaasnicolaas,
raman325 and
zxdavb
mib1185
added
the
needs-rebase
|
Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍 |
home-assistant
Bot
added
current
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
iluebbe
force-pushed
the
docs-fritz-powerline-username
branch
from
64b3d96 to
9451fe0
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Proposed change
Add a note to the Username section of the Fritz integration docs clarifying that FRITZ!Powerline devices ignore the username field — only the password is validated. Setup via SSDP auto-discovery would otherwise leave users guessing what to enter.
Type of change
currentbranch).currentbranch).nextbranch).nextbranch).Additional information
Companion to home-assistant/core#167473, which adds a matching hint to the
data_description_usernamestring shown in the config flow form. Targetingnextbecause this pairs with an open core PR againstdev; happy to rebase tocurrentif maintainers prefer.Verified against a real FRITZ!Powerline 1240E and AVM documentation: the device ignores the username entirely and authenticates by password only.
Checklist
currentbranch.nextbranch.