# Teledock

Teledock is a self-hosted infrastructure app. A Telegram bot that lets you manage your Docker setup from your phone—list, start, stop, and inspect containers and stacks, and read their logs—ideal for keeping an eye on a self-hosted stack while you're away. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1954/teledock

## Description

A Telegram bot that lets you manage your Docker setup from your phone—list, start, stop, and inspect containers and stacks, and read their logs—ideal for keeping an eye on a self-hosted stack while you're away.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

27/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (last commit 1733 days ago)
- Popular: 36 (64 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 60 (no serious findings, 5 minor, CI)

## Links

- GitHub: https://github.com/MrMarble/teledock
- Docker Hub: https://hub.docker.com/r/mrmarble/teledock
- Unraid: https://ca.unraid.net/apps/teledock-04csnru1lsijt2?q=teledock

## Common questions

### How do I restrict which Telegram users can control the bot?

Set TELEDOCK_SUPERADMINS to a comma-separated list of Telegram user IDs. Only users in that list will have access.

### How do I deploy Teledock as a Docker container?

Mount the Docker socket at /var/run/docker.sock, set TELEDOCK_TOKEN and TELEDOCK_SUPERADMINS, and run the mrmarble/teledock image.

### Can I inspect containers and view logs from Telegram?

Yes, Teledock supports inspecting containers and seeing logs. It also lists containers, stacks, and images.

### Can Teledock create containers or run commands inside containers?

No, those features are listed as TODO: create container and run command inside container.

### How do I update the Docker image?

Pull mrmarble/teledock again before running the container. The README notes pulling is needed the first time or to update.

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