doc/pages/01.administrate/10.troubleshooting/troubleshooting.md
tituspijean 77d721485a
Refactor admin guide
Co-authored-by: ljf (zamentur) <zamentur@users.noreply.github.com>
Co-authored-by: nathanael-h <7300309+nathanael-h@users.noreply.github.com>
2022-08-04 19:49:06 +02:00

1.4 KiB

title template taxonomy routes
Troubleshooting docs
category
docs
default
/troubleshooting

Here are some general advices when encountering issues with your server.

0. Don't panic.

Stay calm. Most issues are less worse than newcomers usually think. For the love of God (or your favourite deity / animal / food), please don't jump into the "reinstallation spiral" thinking reinstalling your server from scratch will magically fix stuff. Reinstalling is a heavy operation and is not a good long-term strategy for fixing problems. You will get tired and won't learn anything.

1. Look for similar issues on the forum or bugtrackers.

Search the forum for topics similar to the issue you're encountering. If you have issues with a specific app, you may also want to check the corresponding bugtracker of the app, for example here is the bugtracker for the Wordpress app.

2. Ask for help

Either on the forum or the chat: c.f. this page

!!! FOR THE LOVE OF GOD, PLEASE provide basic context! Volunteers can NOT help you if you do not take five minutes to describe your context: which kind of hardware, which YunoHost version, what you are trying to do, what you tried, what happened and the corresponding logs.