60 lines
2.2 KiB
Markdown
60 lines
2.2 KiB
Markdown
|
# bw-updater
|
||
|
|
This script checks if the Bitwarden RS server is up to date, updates it if necessary and sends a message to a Telegram bot.
|
||
|
|
|
||
|
|
## Introduction
|
||
|
|
The trap to avoid when installing custom software is to update it. It seems obvious but it is never very easy because there is often a compilation part, interoperability management between bricks, backups and so on.
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
### Software
|
||
|
|
It is clearly necessary to have deployed a Bitwarden RS instance on your server. I wrote an article about this topic here: https://illuad.fr/2020/06/11/install-a-bitwarden-rs-server.html
|
||
|
|
|
||
|
|
Since a message is sent to a Telegram bot, it is necessary to have one configured. I wrote an article about this topic here: https://illuad.fr/2020/10/27/get-a-telegram-alert-on-a-ssh-login-with-pam.html
|
||
|
|
|
||
|
|
### System
|
||
|
|
This script can run on any GNU/Linux machine.
|
||
|
|
|
||
|
|
This script uses `git`, `cargo`, `curl` and `restorecon` commands but if you have followed my article, some of them are required which means they will necessarily be installed.
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
Since this script must be executed with root rights, it is a good practice to place it in `/usr/local/sbin/`.
|
||
|
|
|
||
|
|
```
|
||
|
|
sudo curl -Lo /usr/local/sbin/bw-updater -sSf https://gitea.illuad.fr/adrien/bw-updater/raw/branch/master/bw-updater
|
||
|
|
sudo chmod 750 /usr/local/sbin/bw-updater
|
||
|
|
```
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
This script requires the configuration of 3 variables to work: `key`, `chat_id` and `username`.
|
||
|
|
|
||
|
|
Variables `key` and `chat_id` correspond to the API key and the chat id obtained during the bot creation process. The variable `username` must match the username with which you installed Bitwarden RS server.
|
||
|
|
|
||
|
|
#### Fast variables setting
|
||
|
|
For the `key` variable.
|
||
|
|
|
||
|
|
```
|
||
|
|
sudo sed -i "s/key=/key=<your_key>/" /usr/local/sbin/tls-checker
|
||
|
|
```
|
||
|
|
|
||
|
|
For the `chat_id` variable.
|
||
|
|
|
||
|
|
```
|
||
|
|
sudo sed -i "s/chat_id=/chat_id=<your_chat_id>/" /usr/local/sbin/tls-checker
|
||
|
|
```
|
||
|
|
|
||
|
|
For the `username` variable.
|
||
|
|
|
||
|
|
```
|
||
|
|
sudo sed -i "s/username=/username=<your_username>/" /usr/local/sbin/tls-checker
|
||
|
|
```
|
||
|
|
|
||
|
|
## Automation
|
||
|
|
Running this script automatically is a good idea, here is what you should have in the cron jobs of the root user.
|
||
|
|
|
||
|
|
```
|
||
|
|
sudo crontab -l
|
||
|
|
0 1 * * * /usr/local/sbin/bw-updater
|
||
|
|
```
|
||
|
|
|
||
|
|
Every day at 1:00 am, the script will check if the Bitwarden RS server is up to date.
|