Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/erfjab/holderbot
Telegram bot for managing the Marzban panel with unique capabilities.
https://github.com/erfjab/holderbot
bot free holderbot marzban marzban-api-python open-source project-x pyrogram pyrogram-bot python3 telegram telegram-bot v2rayn v2rayng
Last synced: 1 day ago
JSON representation
Telegram bot for managing the Marzban panel with unique capabilities.
- Host: GitHub
- URL: https://github.com/erfjab/holderbot
- Owner: erfjab
- Created: 2024-01-03T20:31:09.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2024-11-09T22:56:10.000Z (about 1 month ago)
- Last Synced: 2024-12-03T04:35:30.732Z (9 days ago)
- Topics: bot, free, holderbot, marzban, marzban-api-python, open-source, project-x, pyrogram, pyrogram-bot, python3, telegram, telegram-bot, v2rayn, v2rayng
- Language: Python
- Homepage: https://t.me/Erfjabs
- Size: 110 KB
- Stars: 247
- Watchers: 5
- Forks: 63
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-freedom - Holderbot
- awesome-freedom - Holderbot
README
## 1. Server Setup
### 1.1: Update the Server
Ensure your server is up to date:
```bash
sudo apt update && sudo apt upgrade -y
```
### 1.2: Install Docker
Install Docker using this command:
```bash
curl -fsSL https://get.docker.com | sh
```
---
## 2. Download and Configure
### 2.1: Create Directory and Download `docker-compose.yml`
Create the necessary directory and download the `docker-compose.yml` file:
```bash
mkdir -p /opt/erfjab/holderbot/data
curl -o /opt/erfjab/holderbot/docker-compose.yml https://raw.githubusercontent.com/erfjab/holderbot/master/docker-compose.yml
cd /opt/erfjab/holderbot
```
### 2.2: Download and Configure `.env`
Download the example environment file:
```bash
curl -o .env https://raw.githubusercontent.com/erfjab/holderbot/master/.env.example
```
Edit the `.env` file to add your **Telegram Bot Token** and **API keys**:
```bash
nano .env
```
---
## 3. Run the Bot
### 3.1: Pull the Latest Docker Image
Pull the latest Docker image for the bot:
```bash
docker compose pull
```
### 3.2: Start the Bot
Start the bot in detached mode:
```bash
docker compose up -d
```
### 3.3: Verify the Bot is Running
Check the status of running containers:
```bash
docker compose ps
```
---
## Updating the Bot
To update the bot to the latest version:
1. Pull the latest Docker image:
```bash
docker compose pull
```
2. Restart the bot:
```bash
docker compose up -d
```
---
## Managing the Bot with Docker
### Restart the Bot
```bash
docker compose restart
```
### Stop the Bot
```bash
docker compose down
```
### View Real-Time Logs
```bash
docker compose logs -f
```
---
## Contact & Support
- Telegram Channel: [@ErfJabs](https://t.me/ErfJabs)
Feel free to ⭐ the project to show your support!
[](https://starchart.cc/erfjab/holderbot)