We're thrilled to have you here! To ensure a smooth and efficient bug-reporting process, we've put together this guide. Please take a moment to familiarize yourself with our practices and procedures.
Identifying bugs
Before you proceed, it's crucial to ascertain whether what you're encountering is indeed a bug. If you're struggling to understand how to perform a task, experiencing problems accessing your server, unable to install the server or want a new widget in Rocket.Chat, these are not considered bugs.
If your concern aligns with the non-bug category, kindly refer to the provided resources in our documentation. Suggestions for new features should be submitted in the forums.
Before reporting a bug
Before you report a new issue, please:
Thoroughly read the documentation.
Ensure you're running the latest version of Rocket.Chat. An update might resolve your issue.
Try to identify reproducible steps. If we can reproduce it, we can fix it faster.
Check all your logs for errors. See the #gathering-logs section for guidance.
Search the forums using a few different search terms.
Search the issues for your bug. If you find it, carefully check that it is identical and give it a thumbs up. If it differs, add some additional information to the ticket. This will help give us a fuller picture.
Please proceed if you've done all of the above and still need to report a bug.
How to report a bug?
Giving clear background information will help save a lot of time. When reporting a new bug, please include the following information to promote effective bug fixing:
Operating system/ version / architecture (64-bit?)
Browser type and version, including any add-ons. (e.g., AdBlocker, NoScript, etc.)
Rocket.Chat version
Expected behavior
Actual behavior
Steps to reproduce the bug consistently
Relevant errors and other log output
Screenshots, if applicable
You can register your bug at the following places based on the platform you're using:
Determining Rocket.Chat version
You can find your Rocket.Chat version in two ways:
As an Admin, log into you r Rocket.Chat. Navigate to Administration -> Workspace -> Info
Append
/api/infoto your Rocket.Chat URL
Gathering logs
Browser logs: To collect logs from your browser, press Ctrl/Cmd + Shift + j. Errors will appear in red.
Server logs: As an Admin, log into your Rocket.Chat. Navigate to Administration -> Workspace -> View Logs It's often helpful to open this in another browser, reproduce the issue, and observe any exceptions that pop up in the logs. Don't forget to check your web server logs and general system logs as well.
We appreciate your effort in helping us improve our software. Thank you for your contribution!