Steps to reproduce:

Install Zabbix appliance by following this page:

https://www.zabbix.com/documentation/current/en/manual/appliance

If you feed a search engine a text like "zabbix appliance replace_user" you will get a lot of complaints. We know that it happens sometimes, the deployment fails in the middle of the process for some unknown reason. In result - you get an "unfinished" appliance that you won't be able to use. We also know what to do in this case - re-deploy. In 99% of the cases it helps.

But as I can see our users do not know that. What they do is seeking help from community or trying to fix the installation themselves. For example, this case:

https://www.zabbix.com/forum/zabbix-troubleshooting-and-problems/410545-access-denied-for-user-replace_user-localhost-using-password-yes

(scroll down to comment #10 for my comment that led to creating this issue)

Result:

Users do not know what to do.

Expected:

A troubleshooting section in the documentation explaining what to do. With examples, like "replace_user" screenshot and probably more.