- Compatible XF 2.x versions
- 2.3
- Additional requirements
- PHP 8.1+; cURL, JSON, and OpenSSL extensions; Free Telegram bot created via @BotFather
- License
- MIT License
Telegram Free Cloud Backup
Automated, encrypted, zero-cost XenForo database and file backups using Telegram cloud storage.
Uses
If so, [Olakunlevpn] Telegram Free Cloud Backup provides an enterprise-grade off-site backup pipeline built specifically for XenForo 2.3+.
Major Features
Automated Cloud Backups
Interactive Two-Way Telegram Bot (Webhook Mode)
2 GB Single-File Uploads (Local Bot API Mode)
Security & Client-Side Encryption
Administration & Recovery Tools
Telegram Bot Commands Cheatsheet
Quick Setup (Under 3 Minutes)
Requirements
Automated, encrypted, zero-cost XenForo database and file backups using Telegram cloud storage.
Uses
- Do you want an automated, off-site disaster recovery solution for your XenForo forum without paying monthly cloud storage fees (Amazon S3, Dropbox, Google Drive, Backblaze)?
- Do you want to trigger database or full forum backups directly from your mobile phone using Telegram commands?
- Do you want client-side AES-256 encryption so neither Telegram nor any third party can ever view your database or member data?
- Do you need to store large archives (up to 2 GB per file) directly in private Telegram channels or groups?
- Do you want automated retention policies that purge expired backups from both the server and Telegram automatically?
If so, [Olakunlevpn] Telegram Free Cloud Backup provides an enterprise-grade off-site backup pipeline built specifically for XenForo 2.3+.
Major Features
Automated Cloud Backups
- Multiple Backup Scopes: Back up your Database, Attachments, Source Code, or Full Forum Archive independently.
- Low-Memory Streaming: Streams large database dumps and archives directly through chunking pipes, preventing PHP
memory_limitexhaustion on low-memory servers. - Smart Cloud Retention Policy: Automatically deletes old backup messages from Telegram and purges server database records once your configured retention limit is reached.
- Automatic Temp Cleanup: Scheduled maintenance crons ensure temporary dump files and sliced parts never consume unneeded local disk space.
Interactive Two-Way Telegram Bot (Webhook Mode)
- Real-Time Remote Commands: Trigger and monitor backups directly from your Telegram app:
/backup_now— Triggers an immediate database backup in the background./backup [type]— Starts a backup fordatabase,attachments,source_code, orfull./status— Reports XenForo version, server disk usage, bot mode, and last backup outcome./history— Lists the 5 most recent backups, byte sizes, and completion statuses./help— Displays the command cheatsheet.
- Zero-Friction Auto-Registration: Saving your Bot Token and Chat ID in XenForo automatically registers all commands across all chat scopes, activates the persistent blue [Menu] button, and connects the secure webhook.
- Strict Sender Authorization: Validates incoming updates against your configured Telegram Chat ID. Unauthorized users or group members are rejected immediately.
- Secret Token Protection: Validates Telegram's
X-Telegram-Bot-Api-Secret-Tokenheader for tamper-proof request authenticity.
2 GB Single-File Uploads (Local Bot API Mode)
- Eliminate Chunking: Point the add-on to a local or private instance of Telegram's open-source telegram-bot-api server to raise the per-file limit from 50 MB to 2,000 MB (2 GB).
- Direct File Transfer: Upload entire multi-gigabyte forum databases and archives as single files without splitting.
Security & Client-Side Encryption
- Client-Side AES-256-CBC: Encrypts backup chunks on your server prior to transmission using OpenSSL with PBKDF2 key derivation.
- Zero Plaintext in the Cloud: Even if your Telegram channel is compromised, your backup data remains unreadable without your master encryption passphrase.
Administration & Recovery Tools
- Admin CP History Dashboard: View backup dates, types, raw sizes, chunk counts, encryption status, and execution states.
- Local Chunk Merger: Built-in tool to merge and decrypt
.part*files downloaded manually from Telegram. - Headless CLI Runner: Dedicated CLI command (
php cmd.php xf-addon:ol-tg-backup) for server crons, scripts, and deployment pipelines.
Telegram Bot Commands Cheatsheet
| Command | Arguments | Description |
|---|---|---|
/backup_now | None | Immediately starts a database backup in the background. |
/backup | [type] | Starts a backup for specified type: database, attachments, source_code, or full. |
/status | None | Returns forum title, XenForo version, server disk space (free/used), active API mode, and latest backup summary. |
/history | None | Formats and displays the 5 most recent backups, byte sizes, and statuses. |
/help | None | Displays the list of available commands and usage instructions. |
Quick Setup (Under 3 Minutes)
- Create your Telegram Bot: Open Telegram, search for @BotFather, send
/newbot, and copy the provided Bot Token. - Create a Private Group or Channel:
- Recommended (Private Group): Provides interactive slash command autocompletion menu (
/) and the blue [Menu] button. - Private Channel: Ideal for a silent, broadcast-only archive repository.
- Recommended (Private Group): Provides interactive slash command autocompletion menu (
- Add Bot as Admin: Add your bot to the group/channel as an Administrator with permission to post messages. (For groups, disable group privacy in @BotFather via
/setprivacy->Disable). - Save in XenForo: In Admin CP, go to Setup -> Options -> [Olakunlevpn] Telegram Free Cloud Backup Options, paste your Bot Token, Chat ID, and optional Encryption Passphrase, then click Save.
- Done: XenForo automatically registers your commands, menu button, and webhook instantly! Click Backup Database Now in Tools -> Telegram Backup to run your first backup.
Requirements
- XenForo 2.3.0 or higher
- PHP 8.1.0 or higher
- PHP
curl,json, andopensslextensions - Free Telegram account (for bot creation via @BotFather)