# Telegram Archive

Telegram Archive is a self-hosted backup app. Automated Telegram backup service that periodically archives messages, media, edits and deletions from your chats, groups and channels to a machine you host. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1713/telegram-archive

## Description

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.

## Health score

69/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 11 days ago)
- Popular: 48 (249 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 40 (4 GB minimum RAM, runs on ARM)
- Security check: 88 (no serious findings, 2 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/drumsergio/telegram-archive
- Unraid: https://ca.unraid.net/apps/telegram-archive-18lc0wv0jbjwej?q=telegram-archive
- Official website: https://geiserx.github.io/Telegram-Archive/

## 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.

## Alternatives

- 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1713/telegram-archive), the self-hosted and open-source app directory.
