Telegram Archive

Automated Telegram backup service that periodically archives messages, media, edits and deletions from your chats, groups and channels to a machine you host.

  • Backup
  • Network Services
  • Tools & Utilities
Automated Telegram backup service that periodically archives messages, media, edits and deletions from your chats, groups and channels to a machine you host. It runs scheduled full exports with optional real-time listening via Telethon, stores data in SQLite or PostgreSQL with media deduplication and configurable retention, and unlike Telegram Desktop's one-off export it keeps earlier message versions and deleted messages. Intended for self-hosters who want a durable copy of their Telegram history, browsable with the separate Telegram Archive Viewer container.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

69/100 Good

Maintained
100last commit 11 days ago
Popular
48249 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
404 GB minimum RAM, runs on ARM
Security check
88no serious findings, 2 minor, CI, tests

Availability: platform listings confirmed today, links checked 38 days ago

GitHub stars
249
Open issues
1
Last commit
2026-11-10
Latest release
v9.7.0
License
GPL-3.0
Activity
declining

Checked 10 days ago - source: GitHub (GeiserX/Telegram-Archive)

Resources & Compatibility

Minimum requirements: 4 GB RAM, 2 CPU core(s), 2 GB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install Java 17 before starting Install the OpenJDK 17 Java runtime before starting the app, since it needs Java to run and will fail without it. After installing, run `java -version` to confirm the server can find Java. source
  • Add your Telegram bot token Create a Telegram bot and put its token into the app settings, because the token is how the app connects to Telegram and receives messages. Keep the token secret, since anyone who has it can act as your bot. source
  • Webhooks need a trusted HTTPS cert If you configure the app to use webhooks, use a trusted HTTPS certificate for the address Telegram sends updates to, or updates may be rejected. A reverse proxy with a Let’s Encrypt certificate is the usual safe way to do this. source
  • Telegram API credentials Create a Telegram application on Telegram's API portal and add the resulting API credentials before first run. source

Fetched 45 days ago - each note links to its source

Alternatives (12)

  • Briar - Censorship-resistant peer-to-peer messaging that bypasses centralized servers.
  • Conduit - Conduit is a lightweight, self-contained Matrix server written in Rust for running your own chat backend with minimal setup and low system…
  • Element
  • Jami - Jami is a free/libre, end-to-end encrypted communication app for private messaging, voice calls, and video conferences.
  • Matrix - Matrix is a free, open-source protocol and server for secure, decentralized real-time messaging.
  • Mirotalk - Mirotalk is a free, web-based video conferencing tool.
  • Pidgin - Pidgin is a cross-platform chat program that lets you log into multiple messaging networks at once, such as XMPP (Extensible Messaging and…
  • Signal - Signal is a messaging app with privacy at its core.
  • SimpleX Chat - SimpleX Chat is a private messaging app that protects your identity by not using phone numbers or usernames.
  • Snikket - Snikket is a self-hosted personal messaging server that gives you a complete XMPP (Jabber) chat service in a box, providing an open-source,…
  • Stoat Chat - Instant messaging with text, voice, video calling, screen sharing, privacy controls, customizable permissions, moderation, bots, and open-s…
  • Tencent QQ - QQ is a widely used Chinese instant messaging service developed by Tencent, offering chat, voice, and video communication.

Checked 54 days ago - source: AlternativeTo

Common questions

How do I complete the first Telegram login for the backup container?

Set the API ID, API hash, and phone in the .env file, then run the auth command in Docker Compose to enter the code and optional two-step password.

Which port should I use to reach the viewer?

Open the viewer on port 8000 and sign in with the viewer username and password you define.

Does it keep deleted messages and earlier edits?

Yes, it keeps every edit with its earlier text and keeps deleted messages marked as deleted with their text and media.

Will media shared across many chats be stored repeatedly?

No, photos, videos, voice notes, stickers, documents, and link previews are saved once, and files above your size limit are skipped.

Can it back up more than one account?

Yes, it can back up several accounts into one archive and import Telegram Desktop exports.

Answers sourced from github.com

Community

Collected 47 days ago - public community threads