telegram-archive

telegram-archive

Docker app from geiserx's Repository

Overview

Automated Telegram backup service that periodically archives messages and media from your chats, groups, and channels. Uses Telethon for scheduled exports with optional real-time message listening. Supports SQLite or PostgreSQL, media deduplication, and configurable retention.

This is the backup container. For browsing archived messages, install the Telegram Archive Viewer container separately.

Requires Telegram API credentials from https://my.telegram.org

More info: https://github.com/GeiserX/Telegram-Archive

Requirements

Telegram API credentials from my.telegram.org

Runtime arguments

Network
bridge
Privileged
false

Template configuration

Session DataPathrw

Telethon session storage

Target
/data/session
Default
/mnt/user/appdata/telegram-archive/session
BackupsPathrw

Backup data and media files

Target
/data/backups
Default
/mnt/user/appdata/telegram-archive/backups
API IDVariable

Telegram API ID from my.telegram.org

Target
TELEGRAM_API_ID
API HashVariable

Telegram API hash from my.telegram.org

Target
TELEGRAM_API_HASH
Phone NumberVariable

Phone number with country code (e.g. +1234567890)

Target
TELEGRAM_PHONE
ScheduleVariable

Cron schedule for backups (default: every 6 hours)

Target
SCHEDULE
Default
0 */6 * * *
Download MediaVariable

Download media files during backup

Target
DOWNLOAD_MEDIA
Default
true
Max Media Size (MB)Variable

Maximum media file size to download in MB

Target
MAX_MEDIA_SIZE_MB
Default
100
Enable ListenerVariable

Enable real-time message listening between scheduled backups

Target
ENABLE_LISTENER
Default
false
Chat IDsVariable

Comma-separated chat IDs to back up (empty = all chats)

Target
CHAT_IDS
Chat TypesVariable

Types of chats to back up

Target
CHAT_TYPES
Default
private,groups,channels

Download Statistics

10,708
Total Downloads

Details

Repository
drumsergio/telegram-archive:latest
Last Updated2026-05-04
First Seen2026-04-06

Run telegram-archive on Unraid.

telegram-archive is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.