paperless-telegram-bot

paperless-telegram-bot

Docker app from geiserx's Repository

Overview

Telegram bot for managing your Paperless-NGX document archive. Upload documents by sending files or photos, search your archive, tag documents, and organize your inbox — all from Telegram without accessing the web UI.

Features health check endpoint, user whitelisting, and auto-detection of inbox tags.

Requires a running Paperless-NGX instance and a Telegram bot token.

More info: https://github.com/GeiserX/paperless-telegram-bot

Requirements

Paperless-NGX instance and Telegram bot token from @BotFather

Runtime arguments

Network
bridge
Privileged
false

Template configuration

Health PortPorttcp

Health check endpoint port

Target
8080
Default
8080
Bot TokenVariable

Telegram bot token from @BotFather

Target
TELEGRAM_BOT_TOKEN
Paperless URLVariable

Paperless-NGX instance URL

Target
PAPERLESS_URL
Default
http://paperless:8000
Paperless TokenVariable

Paperless-NGX API authentication token

Target
PAPERLESS_TOKEN
Allowed UsersVariable

Comma-separated Telegram user IDs (empty = open access)

Target
TELEGRAM_ALLOWED_USERS
Public URLVariable

User-facing Paperless URL for clickable links (defaults to PAPERLESS_URL)

Target
PAPERLESS_PUBLIC_URL
Max ResultsVariable

Maximum search results to display

Target
MAX_SEARCH_RESULTS
Default
10

Download Statistics

1,868
Total Downloads

Details

Repository
drumsergio/paperless-telegram-bot:latest
Last Updated2026-03-27
First Seen2026-04-06

Run paperless-telegram-bot on Unraid.

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