Skip to main content

Prerequisites

This page covers all prerequisites for deploying router monitoring scripts.

System Requirements

Development Machine

Mac Deploy Script

  • macOS or Linux system
  • Python 3 (for HTTP server)
  • SSH client (built-in)
  • Network access to router

Version Manager Script

  • macOS or Linux system
  • curl and jq installed (for development machine only)
  • SSH access to VPS server (for uploads)
  • Supabase credentials

Router Requirements

Hardware Requirements

  • OpenWrt-based firmware
  • Cellular modem with AT command support
  • SIM slot(s) - single or multiple SIM slots supported
  • Sufficient storage for scripts and logs

Software Requirements

  • SSH access enabled
  • Required packages installed:
    opkg update
    opkg install curl nmap at-cmd

Note: The scripts use basic shell tools (grep, awk, cut, tr) for JSON parsing instead of jq, and use curl for downloads instead of wget.

Network Requirements

  • Internet connectivity for Supabase API calls
  • LAN access for device monitoring
  • DHCP server running for lease monitoring

Supabase Setup

API Configuration

  1. Get Supabase URL and API Key from your project settings
  2. Configure Row Level Security (RLS) policies if needed
  3. Test API connectivity from your development machine

Network Configuration

Router Network Setup

LAN Configuration

  • Subnet: Typically 192.168.1.0/24 or 192.168.0.0/24
  • DHCP Server: Must be enabled and running
  • Firewall: Allow outbound HTTPS (port 443) for Supabase

Cellular Configuration

  • SIM Card: Inserted and activated
  • APN Settings: Configured for your carrier
  • Data Connection: Active and working

Development Machine Network

Mac Deploy Script

  • Same network as router (for HTTP server)
  • Port 8000 available (for temporary HTTP server)
  • SSH access to router

Once all prerequisites are met, you can proceed with deployment using one of the available methods.