{"id":3505,"date":"2023-12-26T09:14:56","date_gmt":"2023-12-26T15:14:56","guid":{"rendered":"https:\/\/promincproductions.com\/blog\/?p=3505"},"modified":"2023-12-26T09:21:47","modified_gmt":"2023-12-26T15:21:47","slug":"home-assistant-integration-failed-setup-will-retry","status":"publish","type":"post","link":"https:\/\/promincproductions.com\/blog\/home-assistant-integration-failed-setup-will-retry\/","title":{"rendered":"Home Assistant Integration “Failed setup, will retry”"},"content":{"rendered":"

Have you ever seen the Failed setup, will retry<\/code> message in a Home Assistant integration? This message can show at times on a cloud based integration where Home Assistant is no longer communicating with the remote cloud service. The technical reason is that the token is no longer valid for one reason or another and thus the connection is failing. What causes this? That’s a mystery for another day – this post is focused on just getting past it for now.<\/p>\n\n\n

\n
\"How<\/figure>\n<\/div>\n\n\n

To solve this issue you’ll need a method to edit the files of Home Assistant – well just one file really. Typically SSH access or FTP access to the server is needed for this.<\/p>\n\n\n\n

\n
\n

In my case, the Geocaching integration<\/a> was failing. Once upon a time this was working, but then failed for a long time<\/em>. I got sick of seeing the red box today and wanted to solve.<\/p>\n<\/div>\n\n\n\n

\n
\"Failed<\/figure>\n<\/div><\/div>\n<\/div>\n\n\n\n

How to Repair the Failed Authentication<\/h2>\n\n\n\n

To fix a failed integration connection, the bad authentication credentials first needs to be removed. Then a restart of Home Assistant and it will be ready to re-configure the connection.<\/p>\n\n\n\n

Backup Configuration<\/h3>\n\n\n\n

It’s a wise idea to first backup the current configuration file in case something unexpected occurs. To do so, simply make a copy of the file by downloading it via FTP to your local machine or making a copy via SSH.<\/p>\n\n\n\n

## replace [YYYYMMDD] with the current date\ncp .\/.storage\/core.config_entries .\/.storage\/core.config_entries.bak.[YYYYMMDD]<\/code><\/pre>\n\n\n\n
Remove the Broken Cloud Service Connection<\/h3>\n\n\n\n
Open the .storage\/core.config_entries<\/code> file in an editor like Nano or Vim and look for the entry that has the failed connection.  In the How to Find the Configuration<\/a><\/strong> section below the line number is found.  The entry starts with an opening curly brace ({<\/code>) and ends with a closing curly brace (}<\/code>) – it may or may not have a trailing comma.<\/p>\n\n\n\n
Example:<\/p>\n\n\n\n
      {\n        \"entry_id\": \"456...\",\n        \"version\": 1,\n        \"domain\": \"geocaching\",\n        \"title\": \"PromInc\",\n        \"data\": {\n          \"auth_implementation\": \"cloud\",\n          \"token\": {\n            \"access_token\": \"eyJhbGciOi...\",\n            \"token_type\": \"bearer\",\n            \"expires_in\": 3599,\n            \"refresh_token\": \"8f7...\",\n            \"service\": \"geocaching\",\n            \"expires_at\": 1690974608.435786\n          }\n        },\n        \"options\": {},\n        \"pref_disable_new_entities\": false,\n        \"pref_disable_polling\": false,\n        \"source\": \"user\",\n        \"unique_id\": \"prominc\",\n        \"disabled_by\": null\n      },<\/code><\/pre>\n\n\n\n
Remove\/delete this entire block and save the .storage\/core.config_entries<\/code> file.<\/p>\n\n\n\n
Restart Home Assistant<\/h3>\n\n\n\n
In Home Assistant, go to the Settings<\/strong> page.  Then click the three dots menu icon in the top right and choose Restart Home Assistant<\/strong>.  Then choose the Restart Home Assistant<\/strong> option and click the Restart<\/strong> button.<\/p>\n\n\n\n
Reconfigure Cloud Integration Credentials<\/h3>\n\n\n\n
Now that the bad cloud integration credentials have been cleared, it’s possible to reconfigure the service.  Go to Settings -> Devices & services<\/strong> and find the failed integration.  The integration was removed and thus clicking the + Add Integration<\/strong> button is needed.  Search for the integration and go through the cloud integration steps.  Once complete, the integration should be working as expected once again!<\/p>\n\n\n
\n
\"Cloud<\/figure>\n<\/div>\n\n\n
When I saw that the integration was removed I got a bit nervous that my dashboards and other usages of this integration would have required attention to reconfigure them.  Thankfully that wasn’t the case – likely because it was still configured in .storage\/core.device_registry<\/code> and thus the device and entity IDs did not change.<\/p>\n\n\n\n
Here you can see that a dashboard this integration was added to still works after this authentication update.<\/p>\n\n\n
\n
\"Integration<\/figure>\n<\/div>\n\n\n
 <\/p>\n\n\n\n
How to Find the Configuration<\/h2>\n\n\n\n
If using a Linux based system, grep<\/code> is a tool available to search the files of the system.  If you’ve never used it, it’s worth learning – a great search tool!<\/p>\n\n\n\n
In Home Assistant I clicked into the integration and saw that the account name is set to PromInc<\/strong>.  That’s the clue of what I need to search for using grep<\/code>.<\/p>\n\n\n
\n
\"Finding<\/figure>\n<\/div>\n\n\n
grep -rn PromInc .\/<\/code><\/pre>\n\n\n\n
This returned many results, but a quick scan indicated 2 possible areas in the configuration that would contain the source of the issue.<\/p>\n\n\n\n
.\/.storage\/core.config_entries:796:        \"title\": \"PromInc\",\r\n.\/.storage\/core.device_registry:1527:        \"name\": \"Geocaching PromInc\",\r<\/code><\/pre>\n\n\n\n
The second file core.device_registry<\/code> is used to define what devices are added to your Home Assistant instance.  [reference<\/a>]<\/p>\n\n\n\n
But the first file core.config_entries<\/code> indicates in the name that we are on the right path – a file that handles the configuration!!! [reference<\/a>]<\/p>\n\n\n\n
With the power of grep<\/code> paired with a bit of mental deduction we were able to find the file to edit quickly and easily!<\/p>","protected":false},"excerpt":{"rendered":"
Have you ever seen the Failed setup, will retry message in a Home Assistant integration? This message can […]<\/p>\n","protected":false},"author":1,"featured_media":3515,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"wprm-recipe-roundup-name":"","wprm-recipe-roundup-description":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[387,332],"tags":[331],"class_list":["post-3505","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-home-assistant","category-smart-home","tag-home-assistant"],"jetpack_featured_media_url":"https:\/\/promincproductions.com\/blog\/wp-content\/uploads\/2023\/12\/home-assistant-integration-failed-setup.png","jetpack_shortlink":"https:\/\/wp.me\/p4BbcR-Ux","jetpack_sharing_enabled":true,"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/posts\/3505","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/comments?post=3505"}],"version-history":[{"count":4,"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/posts\/3505\/revisions"}],"predecessor-version":[{"id":3516,"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/posts\/3505\/revisions\/3516"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/media\/3515"}],"wp:attachment":[{"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/media?parent=3505"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/categories?post=3505"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/promincproductions.com\/blog\/wp-json\/wp\/v2\/tags?post=3505"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}