BetterDesk/dev_modules

Development Modules

This directory contains development and testing utilities for BetterDesk Console.

Contents

Testing Scripts

• test_ban_api.sh - Test script for ban/unban API endpoints
  • Tests device banning functionality
  • Validates API responses
  • Usage: ./test_ban_api.sh

Diagnostic Tools

• check_database.py - Database inspection and validation tool

  • Checks database schema
  • Verifies migrations applied
  • Lists devices and their status
  • Usage: python3 check_database.py

• check_and_fix_database.sh - Database Schema Checker & Fixer ⭐

  • Automatically detects database location
  • Validates all required tables and columns
  • Fixes missing or incorrect schema
  • Creates backup before making changes
  • Creates admin user if missing
  • Usage: sudo ./check_and_fix_database.sh [database_path]
  • Example: sudo ./check_and_fix_database.sh /opt/rustdesk/db_v2.sqlite3
  • Use this if you have login problems!

• fix_peer_columns.sh - Quick Fix for Device Errors ⭐

  • Adds missing columns to peer table (updated_at, deleted_at, etc.)
  • Fixes "no such column: updated_at" error
  • Usage: sudo ./fix_peer_columns.sh [database_path]
  • Use this if you get 500 errors when editing devices!

• fix_systemd_services.sh - Fix Systemd Services for API Binaries ⭐ NEW

  • Scans for all RustDesk systemd services (hbbs.service, rustdesksignal.service, etc.)
  • Updates ExecStart to use API-enabled binaries (hbbs-v8-api, hbbr-v8-api)
  • Creates backup of original service files
  • Usage: sudo ./fix_systemd_services.sh [rustdesk_path]
  • Example: sudo ./fix_systemd_services.sh /opt/rustdesk
  • Use this if RustDesk services still use original binaries after installation!

Development Scripts

• update.ps1 - PowerShell update script (Windows development environment)
  • Alternative to update.sh for Windows
  • Updates web console components

Usage

These tools are for development and testing only. They are not required for production deployment.

Requirements

• Python 3.8+ (for check_database.py)
• Bash (for test_ban_api.sh)
• curl (for API testing)

Notes

• These scripts assume a local or test RustDesk server installation
• Always test on non-production systems first
• See main README.md for production deployment

Contributing

When adding new development tools:

1. Document usage in this README
2. Add appropriate shebang and error handling
3. Include comments explaining functionality
4. Test on clean environment before committing