Skip to content

Troubleshooting and help

Jump to bottom
madmachinations edited this page Jan 4, 2025 · 4 revisions

So it's all gone wrong huh?

Please read the following sections for how best to proceed:

Step 1 - Burn it down

Purge everything.

Shutdown and delete the server.

Delete the container image so it's not cached anywhere on your system.

Make sure the persisted files for the config and web session are deleted also.

If you have the custom component installed on home assistant, delete that integration and delete the component.

Reboot your system, and go through the setup steps again.

MAKE SURE YOU MEET THE INSTALLATION REQUIREMENTS

Step 2 - Post on the community support discussion board

If you're still stuck, or you don't understand an instruction, make a post on the community discussion board here:

https://github.com/madmachinations/home-assistant-alexa-shopping-list/discussions/categories/community-support

Step 3 - If something is clearly broken or the other steps haven't worked

If you've read all the documentation and been through the setup steps twice, and you're getting an weird error or strange behaviour - then you can go further.

First check the issue list to see if there is an open issue already which looks like the problem you have. If you find something similar, post in that existing issue.

Please DO NOT just open a new issue effectively just saying "doesnt work" and dump an error. Details are needed:

  • What OS are you trying to run the server on
  • How did you install the server? Is this via the HASS Add-on? Is it the pre-built container? Did you install it manually with python?
  • What hardware is this running on? Is this a raspberry pi? Is this mini-pc or desktop-pc? What architecture is the CPU?
  • Have you read the requirements and you're sure you meet all of them
  • Have you done step 1 in this troubleshooting and just started again and got the same problem?
  • What amazon url are you trying to use?
  • Describe the steps you personally went through, what system are you running the client on? What messages did it say? What step did you get up to in the whole installation process?

It maybe that some of those questions don't apply to the situation you're experiencing. But please answer as many of them as are relevant to your problem.

And finally, the most important of all, you must describe as well as you can how I or somebody else might be able to replicate the conditions which have lead to your problem.

If the problem can't be replicated, the problem can't be helped.

Clone this wiki locally