- Print
- DarkLight
- PDF
Support Prerequisites
- Print
- DarkLight
- PDF
This document serves as a key resource for understanding the specific conditions and criteria that must be met to ensure full support eligibility. Additionally, it delves into the aspects of version durability, highlighting how different versions are maintained and supported over time. This information is crucial for users and administrators to effectively manage and sustain their Rocket.Chat installations, ensuring they remain up-to-date, secure, and fully functional.
Support window duration
Each release of Rocket.Chat comes with a six-month support period from its release date. Once this period expires, hosted services such as the Push Gateway and Marketplace will cease to function for that particular version. During the support window, Rocket.Chat focuses on delivering security patches and responding to support queries concerning configuration and usage for the versions specified. Any bugs that are not security-related will be addressed solely in future releases.
Each Rocket.Chat version is supported for six months post-release.
Requirements for official support
To obtain official support, installations must meet specific requirements, ensuring the support request pertains to the Rocket.Chat application and not external factors. The installation should run the Docker image provided by the Rocket.Chat team to ensure this. Rocket.Chat requires the installation to run on their Docker image to isolate external factors. This approach ensures efficient support by avoiding issues like:
Missing or outdated dependencies.
Use of non-official versions.
Deploy with Docker & Docker Compose
Before an app version reaches its end-of-life (EOL), it's crucial to upgrade to ensure you continue to receive official support and have the latest security features. This is particularly important for white-label app users, as they might not receive automatic updates. Ensure you follow the version support dates to maintain optimum app performance and security standards.
Check version durability and note that numbers enclosed in brackets are the latest patches for the corresponding release.
What to do before deprecation
Before the end of the deprecation period, we strongly recommend all the workspaces on Rocket.Chat plans to upgrade to a supported version for continued access to cloud services, mobile, and desktop apps. If you do not wish to update, Rocket.Chat provides workspace owners with a variety of options for managing their workspaces in the manner of your choosing. You must implement the following alternatives to our cloud services and published apps:
Mobile and desktop apps: You must compile each app from our open-source code and publish your own builds to relevant app stores.
Push notifications: You will need to deploy your own push notification server.
Apps: You must develop and sideload your own applications instead of installing them through our Marketplace.
MongoDB version support
Each Rocket.Chat release supports different MongoDB versions. Following the official MongoDB documentation for upgrade guides is essential to ensure no versions are skipped during the upgrade process.
Rocket.Chat Release | Supported MongoDB Versions | Deprecated Version |
---|---|---|
1.x | 3.2, 3.4, 3.6, 4.0 | 3.2 |
2.x | 3.4, 3.6, 4.0 | 3.4 |
3.x | 3.4, 3.6, 4.0 | 3.4 |
4.x | 3.6, 4.0, 4.2, 4.4, 5.0 | 3.6, 4.0 |
5.x | 4.2, 4.4, 5.0 | 4.2 |
6.x | 4.4 | |
7.x | 5.0 |
It's possible to bypass the MongoDB version check by using the environment variable
BYPASS_MONGO_VALIDATION=true
. Bear in mind that this work around should be used only when extrictly necessary and may prevent some functionalities to work properly or even prevent the server to start.
Browser support
Due to the rapid evolution of the browser ecosystem, support is limited to recent browsers. Supported browsers include the latest three versions of Google Chrome and Mozilla Firefox, the latest two versions of Apple Safari and Microsoft Edge, and the latest version of Microsoft Internet Explorer.
System requirements
Support is limited to installations that meet the requirements described in the system requirements guide.
Monitoring
Monitoring is required for all supported installations with Rocket.Chat supporting the Prometheus and Grafana monitoring stack.
Access to logs
While Rocket.Chat doesn't require server or database access; we might need access to logs to identify issues. Potential logs include server logs, web browser logs, and mobile logs.
By adhering to the guidelines and timelines outlined in this document, you can make informed decisions that contribute to the security, efficiency, and longevity of your Rocket.Chat workspace. Should you have any further questions or require additional clarification, we encourage you to reach out to our support team for expert assistance.