-
Notifications
You must be signed in to change notification settings - Fork 991
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
panel/1.0/troubleshooting: Add note about cert expiration #596
base: master
Are you sure you want to change the base?
Conversation
Expired certificate can create an error that looks like a general communication error, since websocket or XHR requests just fail in very similar way like the service was not responding at all. This could be a quite common case, especially if the certificate renewal (e.g. for Let's Encrypt) is not properly set up.
Not sure how much this is really going to help. |
You're right that the expired cert would be exposed with e.g. the curl command, but I just thought that maybe explicitly listing this potential issue could still help, since you know what to look for. And possibly could just have an "aha moment" while reading the troubleshooting list even without checking those previous steps. |
Also, is issuing the |
If you think this note is worthless feel free to close the PR. |
I didn't say it's worthless, I just want to have real and open discussions about how much of an effect it's really going to have. We'll be taking a look into these smaller PRs after the major docs update PR is merged. |
Sorry, didn't mean to be dramatic. And thanks for letting me know about the plan! The truth is that I found the expired cert with the help of the previous bullet points. My thoughts at the time were that this kind of common issue could be mentioned explicitly still to speed up the debugging process, but that's only speculation of course. Another thing that probably could have helped even more would have been a copy-paste from the error message that is shown in the UI: Let me know if you want me to improve the troubleshooting steps even more with those. I can update this PR or create another. |
Expired certificate can create an error that looks like a general communication error, since websocket or XHR requests just fail in very similar way like the service was not responding at all.
This could be a quite common case, especially if the certificate renewal (e.g. for Let's Encrypt) is not properly set up.