Skip to main content

Router Deployment

This section covers how to deploy and configure router monitoring scripts on your OpenWrt routers.

Deployment Methods​

The mac-deploy.sh script provides the most comprehensive deployment solution for macOS and Linux systems.

Features:

  • Automatic router type detection
  • SSH-based deployment with multiplexing
  • HTTP server for efficient file transfer
  • Comprehensive testing and validation
  • Automatic crontab installation

Quick Start:

./mac-deploy.sh -h 192.168.1.1 -u admin

Learn More →

Windows Setup Script​

For Windows systems, use the windows-router-setup-script-copy-paste.sh script.

Features:

  • Complete script creation on router
  • Configuration file setup
  • Crontab installation
  • Script testing

Learn More →

What Gets Deployed​

Monitoring Scripts​

  • Device Monitoring: Tracks connected devices via network scanning
  • DHCP Monitoring: Monitors DHCP lease information
  • Signal Monitoring: Tracks cellular signal strength
  • SIM Monitoring: Monitors active SIM slot and ICCID

Configuration Files​

  • Supabase Config: Database connection settings
  • Crontab: Scheduled task configuration
  • Router Identity: IMEI and AT port caching

Auto-Update System​

  • Automatic Updates: Scripts check for updates every 2 hours
  • Version Management: Server-side version control
  • Rollback Support: Emergency rollback capabilities

Prerequisites​

System Requirements​

  • SSH access to router
  • Python 3 (for Mac Deploy)
  • Network connectivity
  • Appropriate permissions

Router Requirements​

  • OpenWrt-based firmware
  • SSH server enabled
  • wget utility installed
  • at-cmd utility available

Deployment Process​

  1. Preparation: Ensure prerequisites are met
  2. Connection: Establish SSH connection to router
  3. Detection: Determine router type (single/dual SIM)
  4. Transfer: Download scripts and configuration
  5. Installation: Set up crontab and permissions
  6. Testing: Verify all scripts work correctly
  7. Validation: Confirm monitoring is active

Post-Deployment​

After successful deployment:

  1. Verify Data: Check router dashboard for incoming data
  2. Monitor Logs: Watch for any errors or issues
  3. Test Updates: Verify auto-update system works
  4. Configure Alerts: Set up monitoring alerts if needed

Troubleshooting​

Common issues and solutions:

  • SSH Connection Failed: Check credentials and network
  • Script Testing Failed: Verify Supabase configuration
  • No Data: Check router internet connectivity
  • Update Issues: Verify GitHub access