---

SSHBot

Easily access your servers using SSH over a Telegram Bot. Written in Python, designed for fast, interactive, and secure remote server access.

---

🚀 What is SSHBot?

SSHBot allows you to open and control SSH sessions directly from Telegram. No terminal, no VPN hopping — just your Telegram app.

It supports interactive shells, keyboard shortcuts, and command combinations, making it suitable for real server administration.

💡 New: We have added enhanced terminal rendering, security improvements, and more interactive buttons to make your experience smoother and safer.

---

✨ Features

• 🔐 SSH access over Telegram

• ⌨️ Interactive terminal with visible cursor

• 🖥️ New extended control buttons:

  • Insert, Delete, Home, End
  • Function keys F1–F12
  • Backspace with need of pressing ENTER to execute commands

• 🧠 Keyboard combinations via commands:

  • /ctrl c → Ctrl + C
  • /alt a → Alt + A
  • /shift x → Shift + X
  • /ctrl alt c → Ctrl + Alt + C

• 🛑 Stop SSH sessions instantly

• 🧹 Automatically removes sensitive messages (like passwords)

• 🌍 English & Persian friendly

• 🔒 Security tweaks:

  • Localhost access blocked
  • Fixed Telegram console detection issues

• ⚙️ Runs as a systemd service

• 🐧 Optimized for Linux servers

---

🛡️ Demo Bot — Safe to Use

Try the demo bot here: 👉 https://t.me/ssh4ccess_bot

You can verify the legitimacy and safety of the bot using the /hash command. It compares the running bot code against the official GitHub repository to ensure it is unmodified. ✅

⚠️ Note: This is a demo bot. Sessions may be limited or reset at any time.

---

📥 Installation (One-Line)

Run this command on your server to install SSHBot, including the updated shell installer:

bash <(curl -Ls https://github.com/ItzGlace/SSHBot/raw/refs/heads/main/install.sh)

The installer now includes all recent tweaks and enhancements.

---

🐳 Docker Compose

Run SSHBot inside a container instead of installing it system-wide. Docker Compose builds the Python environment, keeps the original dependencies, and exposes logs via a named volume.

1. Copy the environment template and add your Telegram bot token:

   cp .env.example .env
   # then edit .env and set BOT_TOKEN to your token

2. Build the image and start the service:

   docker compose up -d --build

3. Follow the logs while the bot starts:

   docker compose logs -f sshbot

4. Stop and remove containers with:

   docker compose down

Logs & Persistence

• Logs are written to /var/log/ssh-bot inside the container and persisted in the sshbot-logs volume declared in docker-compose.yml.
• To inspect the logs from the host, mount a path as shown in the compose file (volumes section) or run docker compose logs -f sshbot.

Make sure BOT_TOKEN is populated in your .env file before starting the service — Docker Compose still needs that secret to function.

---

✅ SSHBot is now safer, more interactive, and ready for secure server management via Telegram.

---