whatisgithub

What is rasptele?

maddhruv/rasptele — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

In one sentence

A private Telegram bot that lets you monitor and control a Raspberry Pi Docker homelab, including Pi-hole, without opening any inbound ports.

Mindmap

mindmap
  root((rasptele))
    What it does
      Telegram control plane
      Host and container health
      Pi-hole management
    Tech stack
      Python
      Docker Compose
      Telegram Bot API
      Pi-hole
    Use cases
      Remote Pi monitoring
      Container restarts
      Ad block control
    Security
      No inbound ports
      Allowlisted docker guard
      Single trusted user

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check your Raspberry Pi's CPU, memory, disk, and temperature from Telegram without exposing any inbound port.

USE CASE 2

Restart an allowlisted Docker container on your homelab server directly from a Telegram chat after confirming.

USE CASE 3

Pause or restore Pi-hole ad blocking and view its statistics through Telegram commands.

What is it built with?

PythonDockerTelegram Bot APIPi-hole

How does it compare?

maddhruv/rasptele0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audienceops devopsgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Raspberry Pi with Docker Compose, a Telegram bot token, and your Telegram user ID.

Free to use, modify, and distribute for any purpose, including commercial use, as long as the copyright notice is kept.

So what is it?

Rasptele is a private control system that lets you monitor and manage a Raspberry Pi running Docker containers entirely through Telegram, without opening any inbound network port on the device. It gives one trusted Telegram account a narrow set of commands to check on the health of the Pi and its containers, and it works by having the Pi reach out to Telegram itself rather than waiting for anyone to connect to it. Through Telegram commands, you can see the Pi's CPU, memory, disk space, temperature, and whether it is being throttled, along with the health of its Docker containers. You can list containers and restart only ones that have been explicitly allowed in advance, and only after confirming the action. If you also run Pi-hole, a network ad blocking tool, on the same network, Rasptele can show its statistics and let you temporarily pause or immediately restore its blocking. The system also sends alerts if the host, a container, its own internal safety component, or Pi-hole runs into trouble, and it keeps retrying any notification that failed to send using a small local database, so alerts are not silently lost. A record of recent incidents and actions is kept for review. Support for other tools like qBittorrent, Jellyfin, Coolify, and OpenWrt is mentioned as not yet built. Setting it up involves creating a Telegram bot, finding your personal Telegram numeric ID, downloading a specific tagged release of the project, filling in your bot token and ID into a settings file, and starting it with Docker Compose. Pi-hole support is optional and enabled by adding two more settings once you have it running. The system deliberately keeps the component that touches the Docker socket separate from the bot itself, limiting it to a small set of allowed actions, and mounts the host's files as read only where possible, though the author notes these mounts can still expose some sensitive information to the bot's container. The project recommends running it only on a dedicated, trusted Raspberry Pi that is never exposed directly to the internet, and it is released under the Apache License 2.0.

Copy-paste prompts

Prompt 1
Set up Rasptele on my Raspberry Pi by creating a Telegram bot, finding my user ID, and configuring the .env file.
Prompt 2
Add Pi-hole support to my existing Rasptele deployment by setting the PIHOLE_URL and PIHOLE_PASSWORD variables.
Prompt 3
Deploy Rasptele using Coolify from the exact release tag it recommends.
Prompt 4
Walk me through how Rasptele's docker-guard component limits what the bot can do to my Docker socket.

Frequently asked questions

What is rasptele?

A private Telegram bot that lets you monitor and control a Raspberry Pi Docker homelab, including Pi-hole, without opening any inbound ports.

What language is rasptele written in?

Mainly Python. The stack also includes Python, Docker, Telegram Bot API.

What license does rasptele use?

Free to use, modify, and distribute for any purpose, including commercial use, as long as the copyright notice is kept.

How hard is rasptele to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is rasptele for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.