92 lines
1.9 KiB
Markdown
92 lines
1.9 KiB
Markdown
---
|
||
title: Upgrading to a new release
|
||
---
|
||
|
||
# Preparing
|
||
|
||
The release page contains a changelog, and below it, upgrade instructions. **Read and understand** the release instructions.
|
||
|
||
Some tasks (like database migrations) can take a while, so we advise you to run commands inside a `tmux` or `screen`.
|
||
|
||
# Backup
|
||
|
||
Always make sure your database and `config` folder are properly backuped before performing upgrades.
|
||
|
||
Unless stated otherwise in the release notes, the following steps are enough to upgrade Mobilizon.
|
||
|
||
# Steps
|
||
|
||
### Fetch latest code
|
||
Switch to the `mobilizon` user:
|
||
|
||
```bash
|
||
sudo -i -u mobilizon
|
||
```
|
||
|
||
And navigate to the Mobilizon root directory:
|
||
|
||
```bash
|
||
cd /home/mobilizon/live
|
||
```
|
||
|
||
Fetch the latest tags
|
||
```bash
|
||
git fetch --tags
|
||
```
|
||
|
||
And checkout the tag you want to switch to. For instance, if I want to upgrade to version `v1.1`:
|
||
```bash
|
||
git checkout v1.1
|
||
```
|
||
|
||
### Fetch new dependencies
|
||
Fetch new and/or updated Elixir and NodeJS dependencies
|
||
```bash
|
||
MIX_ENV=prod mix deps.get
|
||
```
|
||
```bash
|
||
cd js
|
||
yarn install
|
||
```
|
||
|
||
### Rebuild Mobilizon's front-end
|
||
```bash
|
||
yarn run build
|
||
cd ../
|
||
```
|
||
|
||
### Recompile Mobilizon
|
||
```bash
|
||
MIX_ENV=prod mix compile
|
||
```
|
||
Let's switch back to your regular user.
|
||
|
||
### Stop running Mobilizon processes
|
||
```bash
|
||
sudo systemctl stop mobilizon
|
||
```
|
||
|
||
### Perform database migrations
|
||
|
||
Go back to the `mobilizon` user.
|
||
```bash
|
||
sudo -i -u mobilizon
|
||
cd live
|
||
MIX_ENV=prod mix ecto.migrate
|
||
```
|
||
### Restart Mobilizon
|
||
Let's switch back one last time to your regular user.
|
||
```bash
|
||
sudo systemctl restart mobilizon
|
||
```
|
||
|
||
You can follow the Mobilizon logs to check that everything works properly.
|
||
```bash
|
||
sudo journalctl -u mobilizon -f
|
||
```
|
||
|
||
**That’s all!** You’re running the new version of Mobilizon now.
|
||
|
||
If you have issues after upgrading, try reviewing upgrade steps and release notes.
|
||
Then feel free to [contact us](../about.md#discuss) or file an issue on [our Gitlab](https://framagit.org/framasoft/mobilizon/issues)
|