Unverified Commit fbbe734a authored by Fongang Rodrique's avatar Fongang Rodrique Committed by gitbook-bot
Browse files

GitBook: [#1603] [Docs]: Upgrade redone

parent 090b7138
# Upgrading Rocket.Chat
Rocket.Chat ships out updates frequently, to fix little bugs, address security issues or make small tweaks on a particular version of the app. All these to improve and help keep the application functional.
Upgrade on the other hand is a complete move to another version and is performed less frequently. A few reasons you may want to upgrade your workspace can be:
* Improvements in performance and stability
* Resolve the potential problems by fixing bugs and errors
* Enjoy new features, experiences and functionalities
{% hint style="info" %}
As of the time of this writing, the current version of Rocket.Chat is [`4.6.3`](https://github.com/RocketChat/Rocket.Chat/releases/tag/4.6.3)`using Node version 14.18.3`
{% endhint %}
{% hint style="danger" %}
For a successful upgrade, it is recommended not to skip any major version. That is, say you want to move from version `1.x.x` to say `4.x.x`, you need to traverse chronologically `1.x.x` -> `2.x.x` -> `3.x.x` -> `4.x.x`. Ideally, it's even better to make more granular steps, and not skip more than two minor versions at a time.
This will prevent a couple of issues.
{% endhint %}
<details>
<summary>Upgrading Rocket.Chat on Docker</summary>
To upgrade your Rocket.Chat setup on Docker, it is recommended you backup your data first if you don't have persistent volume for all your data.
1. Stop container by running:\
&#x20;`docker stop <name_or_id>`
2. Delete container:\
`docker rm <name_or_id>`
3. Delete image `docker rmi <name_image>`
4. Create or download the latest container:\
`docker create <name_or_id>`
5. Start container:\
`docker start <name_or_id>`
</details>
<details>
<summary>Upgrading Rocket.Chat Snap</summary>
The Rocket.Chat snap installation automatically pushes out updates periodically.
**Before performing a major version update, it is recommended to check our forum's announcement section**: [https://forums.rocket.chat/c/announcements/10](https://forums.rocket.chat/c/announcements/10)
You can force an update by running `sudo snap refresh rocketchat-server`
Updating to a major version requires a track change learn more about this in this discussion [https://forums.rocket.chat/t/introducing-snap-tracks/5890](https://forums.rocket.chat/t/introducing-snap-tracks/5890).
Switching to a particular track is done by executing `sudo snap switch rocketchat-server --channel=`x`.x/stable` you will only receive updates relating to this version
To upgrade to a new version, execute
```
sudo snap refresh rocketchat-server --channel=x.x.x/stable
```
</details>
<details>
<summary>Upgrading Rocket.Chat Digital Ocean Oneclick Install</summary>
To upgrade your Rocket.Chat Digital Ocean droplet,
1. Upgrade the update tool:\
`sudo rocketchatctl upgrade-rocketchatctl`
2. Upgrade Rocket.Chat:\
`sudo rocketchatctl update`
3. The server is broken and doesn’t start, because it requires Nodejs 14.x.x\
Install it:\
`sudo apt-get -y update && sudo apt-get install -y curl && curl -sL https://deb.nodesource.com/setup_14.x | sudo bash setup_14.x`\
`sudo apt-get install -y nodejs`\
``\
``If you face any errors with installing node, reboot your system and you’ll be able to continue with the next steps.\
![](<../.gitbook/assets/image (625).png>)
4. If it's not updated already, change the path to new nodejs in the service config:\
`sudo nano /lib/systemd/system/rocketchat.service`\
In the line beginning with “ExecStart=” replace “/usr/local/bin/node” with “/usr/bin/node”
5. Reload the service and start the server:\
`sudo systemctl daemon-reload`\
`sudo systemctl restart rocketchat.service`
6. Check that it’s running:\
`sudo systemctl status rocketchat.service`
</details>
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment