What happens
My Eufy account is registered in Switzerland. The hardware lives in Italy, so I set EUFY_COUNTRY=IT. The bridge refused to log in with this:
[bridge] login attempt failed: /passport/login failed (200/26108):
Email address or password incorrect.
The message points squarely at the credentials, so that is what I debugged. I re-entered the password twice, checked it in a password manager, and only then thought to compare the country code against the old add-on's configuration, where it was CH. With EUFY_COUNTRY=CH the login succeeded immediately — same email, same password, nothing else changed.
It cost me about an hour, and I think it will cost every new user something, because setting the country to where your hardware is rather than where your account was registered is the intuitive reading.
Environment
ha-eufy-sdk-bridge 0.2.0, Docker, network_mode: host- 31 devices, 3 HomeBases
- Account registered in CH, hardware in IT
Two suggestions
1. Distinguish the message, if the upstream response allows it. Eufy returns 200/26108 here. If that code is specific enough to separate a country mismatch from an actual bad password, a different message would end the confusion outright. If it is not distinguishable, then appending a hint to the existing one would still help a lot — something like "check that EUFY_COUNTRY matches the country your account was registered in, not the country you live in."
2. Sharpen the docs comment. docs/docker-compose.md currently reads:
EUFY_COUNTRY: "GB" # your account's country code
"Your account's country code" is technically correct but reads as "your country" at a glance. Making it explicit — account registration country, which may differ from where you live — would prevent the same mistake.
Low effort, and it is the first thing a new user hits.
Happy to test a patched message against a deliberately mismatched country if that is useful.
What happens
My Eufy account is registered in Switzerland. The hardware lives in Italy, so I set
EUFY_COUNTRY=IT. The bridge refused to log in with this:The message points squarely at the credentials, so that is what I debugged. I re-entered the password twice, checked it in a password manager, and only then thought to compare the country code against the old add-on's configuration, where it was
CH. WithEUFY_COUNTRY=CHthe login succeeded immediately — same email, same password, nothing else changed.It cost me about an hour, and I think it will cost every new user something, because setting the country to where your hardware is rather than where your account was registered is the intuitive reading.
Environment
ha-eufy-sdk-bridge0.2.0, Docker,network_mode: hostTwo suggestions
1. Distinguish the message, if the upstream response allows it. Eufy returns
200/26108here. If that code is specific enough to separate a country mismatch from an actual bad password, a different message would end the confusion outright. If it is not distinguishable, then appending a hint to the existing one would still help a lot — something like "check that EUFY_COUNTRY matches the country your account was registered in, not the country you live in."2. Sharpen the docs comment.
docs/docker-compose.mdcurrently reads:"Your account's country code" is technically correct but reads as "your country" at a glance. Making it explicit — account registration country, which may differ from where you live — would prevent the same mistake.
Low effort, and it is the first thing a new user hits.
Happy to test a patched message against a deliberately mismatched country if that is useful.