🛡️ Sentinel dVPN Node Dashboard

A comprehensive, production-ready dashboard for monitoring and managing Sentinel dVPN nodes with advanced analytics, real-time monitoring, and Telegram bot integration.

🌟 Features

Core Dashboard

🎨 Modern Glassmorphism UI - Beautiful dark theme with glass effects
📊 Real-time Monitoring - Live system metrics and node status
💰 Earnings Tracking - Wallet balance with USD conversion via CoinGecko
📈 Performance Metrics - CPU, memory, disk, and network monitoring
🌐 Blockchain Integration - Direct connection to Sentinel network
📱 Mobile Responsive - Works perfectly on all devices
🔐 JWT Authentication - Secure access control

Telegram Bot Integration

🤖 Remote Control - Manage your node from anywhere
📊 Instant Stats - Get node status with a command
🚨 Smart Alerts - Automatic notifications for important events
📈 Performance Monitoring - Regular health checks
💰 Earnings Reports - Daily/monthly estimates
🚀 Speed Testing - Built-in internet speed tests

Advanced Features

⚡ Auto-start on Boot - Systemd service integration
🔄 Health Check System - 24-hour monitoring cycle
📊 Session Tracking - Active connection monitoring
🌍 Multi-RPC Fallback - Reliable blockchain connectivity
📈 Historical Data - Track performance over time
🛠️ API Endpoints - Full REST API for integration

📋 Prerequisites

Raspberry Pi 4 (or compatible Linux system)
Python 3.9+
Sentinel dVPN Node running in Docker
Telegram Bot Token (optional, for bot features)
1GB+ RAM recommended

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/fil0s/sentinel-p2p-dashboard.git
cd sentinel-p2p-dashboard

2. Install Dependencies

# Install Python dependencies
pip3 install -r config/requirements-prod.txt

# For Raspberry Pi users
pip3 install --break-system-packages -r config/requirements-prod.txt

3. Configure Environment

# Copy example configuration
cp config/.env.example config/.env

# Edit with your settings
nano config/.env

Required settings:

NODE_ADDRESS=sentnode1...  # Your node address
WALLET_ADDRESS=sent1...     # Your wallet address
TELEGRAM_BOT_TOKEN=...      # From @BotFather
ADMIN_CHAT_IDS=...         # Your Telegram user ID

4. Run the Dashboard

# Development mode
python3 src/app/app.py

# Production mode with Gunicorn
gunicorn --config config/gunicorn.conf.py src.app.app:app

Access the dashboard at: http://localhost:8080

📱 Telegram Bot Setup

Create a Bot

Message @BotFather on Telegram
Send /newbot and follow instructions
Copy the bot token to .env file

Get Your Chat ID

python3 scripts/utils/get_chat_id.py

Start the Bot

# Run optimized bot with monitoring
python3 src/bot/telegram_bot_optimized.py

Bot Commands

/start - Main menu
/status - Node status
/earnings - Earnings report
/health - Health check
/speedtest - Internet speed test
/metrics - System metrics

🔧 Installation as Service

Dashboard Service

# Install service
sudo cp deployment/systemd/sentinel-dashboard.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable sentinel-dashboard
sudo systemctl start sentinel-dashboard

Telegram Bot Service

# Install bot service
sudo cp deployment/systemd/sentinel-telegram-bot.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable sentinel-telegram-bot
sudo systemctl start sentinel-telegram-bot

📊 API Documentation

Authentication

POST /api/auth/login
Content-Type: application/json

{
  "username": "admin",
  "password": "your_password"
}

Public Endpoints (No Auth Required)

GET /api/health - Health check
GET /api/bot/status - Node status
GET /api/bot/wallet - Wallet balance
GET /api/bot/earnings - Earnings estimates

Protected Endpoints (JWT Required)

GET /api/node/info - Detailed node information
GET /api/sessions - Active sessions
POST /api/speedtest - Run speed test
GET /api/system/metrics - System metrics

🐳 Docker Deployment

Build and Run

# Build image
docker build -f deployment/docker/Dockerfile.prod -t sentinel-dashboard .

# Run container
docker run -d \
  --name sentinel-dashboard \
  -p 8080:8080 \
  -v $(pwd)/config:/app/config \
  -v $(pwd)/data:/app/data \
  sentinel-dashboard

Docker Compose

docker-compose -f config/docker-compose.prod.yml up -d

🌐 Nginx Reverse Proxy

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

📁 Project Structure

sentinel-p2p-dashboard/
├── src/                    # Source code
│   ├── app/               # Flask application
│   │   └── app.py        # Main application
│   ├── api/               # API modules
│   │   ├── blockchain_client.py
│   │   └── system_metrics.py
│   ├── auth/              # Authentication
│   │   └── auth_middleware.py
│   └── bot/               # Telegram bots
│       ├── telegram_bot.py
│       └── telegram_bot_optimized.py
├── frontend/              # Frontend assets
│   ├── static/           # CSS, JS, images
│   └── templates/        # HTML templates
│       └── index.html
├── config/                # Configuration
│   ├── .env.example      # Environment template
│   ├── requirements-prod.txt
│   └── gunicorn.conf.py
├── scripts/               # Utility scripts
│   ├── setup/            # Setup scripts
│   └── utils/            # Helper utilities
├── deployment/            # Deployment configs
│   ├── docker/           # Docker files
│   ├── systemd/          # Service files
│   └── nginx/            # Web server config
├── docs/                  # Documentation
└── tests/                # Test files

⚙️ Configuration

Environment Variables

Variable	Description	Default
`NODE_ADDRESS`	Your Sentinel node address	Required
`WALLET_ADDRESS`	Your wallet address	Required
`SENTINEL_RPC_ENDPOINT`	RPC endpoint	https://sentinel-api.polkachu.com
`TELEGRAM_BOT_TOKEN`	Bot token from BotFather	Optional
`ADMIN_CHAT_IDS`	Comma-separated admin IDs	Optional
`DASHBOARD_SECRET_KEY`	Flask secret key	Auto-generated
`JWT_SECRET_KEY`	JWT signing key	Auto-generated
`PORT`	Dashboard port	8080

Network Configuration

For Raspberry Pi with router issues:

# Enable DMZ mode in router for Pi IP
# Or configure port forwarding:
# - Port 8080 for dashboard
# - Port 3845 for Sentinel node

🔍 Troubleshooting

Dashboard Not Loading

# Check service status
sudo systemctl status sentinel-dashboard

# View logs
sudo journalctl -u sentinel-dashboard -f

# Test API
curl http://localhost:8080/api/health

Telegram Bot Issues

# Check bot service
sudo systemctl status sentinel-telegram-bot

# View bot logs
sudo journalctl -u sentinel-telegram-bot -f

# Test bot manually
python3 src/bot/telegram_bot_optimized.py

Node Connection Issues

# Test node API
curl http://localhost:1177/status

# Check Docker container
docker ps | grep sentinel
docker logs sentinel-p2p-node

📈 Performance Optimization

For Raspberry Pi

Use optimized Telegram bot: telegram_bot_optimized.py
Enable swap if RAM < 2GB
Use ethernet connection for better speeds
Configure router DMZ for maximum bandwidth

Cache Settings

API responses cached for 5 minutes
Wallet balance cached for 10 minutes
System metrics refresh every 30 seconds

🤝 Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Open a Pull Request

📝 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Sentinel Network for the dVPN infrastructure
CoinGecko for price data
Polkachu for RPC endpoints
Community contributors and testers

📞 Support

GitHub Issues: Report bugs
Telegram: Join our community (coming soon)
Documentation: Full docs

🚦 Status

✅ Dashboard: Production Ready
✅ Telegram Bot: Fully Operational
✅ API: Stable
✅ Health Monitoring: Active
✅ Speed Test: Working

Version: 1.0.0
Last Updated: August 2025
Node Address: sentnode1ysdczgrk6lx88krln9ye40hjujseleaarxex5e

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
dashboards		dashboards
deployment		deployment
frontend/templates		frontend/templates
src		src
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
setup.sh		setup.sh

Folders and files

Latest commit

History

Repository files navigation

🛡️ Sentinel dVPN Node Dashboard

🌟 Features

Core Dashboard

Telegram Bot Integration

Advanced Features

📋 Prerequisites

🚀 Quick Start

1. Clone the Repository

2. Install Dependencies

3. Configure Environment

4. Run the Dashboard

📱 Telegram Bot Setup

Create a Bot

Get Your Chat ID

Start the Bot

Bot Commands

🔧 Installation as Service

Dashboard Service

Telegram Bot Service

📊 API Documentation

Authentication

Public Endpoints (No Auth Required)

Protected Endpoints (JWT Required)

🐳 Docker Deployment

Build and Run

Docker Compose

🌐 Nginx Reverse Proxy

📁 Project Structure

⚙️ Configuration

Environment Variables

Network Configuration

🔍 Troubleshooting

Dashboard Not Loading

Telegram Bot Issues

Node Connection Issues

📈 Performance Optimization

For Raspberry Pi

Cache Settings

🤝 Contributing

📝 License

🙏 Acknowledgments

📞 Support

🚦 Status

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages