[{"_1":2,"_164":-5,"_165":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_141":142},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_91":-5,"_92":93,"_132":-5,"_133":11,"_134":17,"_135":11,"_136":-5,"_137":11,"_138":-5,"_139":140},"canonicalUrl","https://hub.docker.com/r/mbraut/nettools/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","mbraut","reponame","nettools","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_46":47,"_49":50,"_51":52,"_53":11,"_54":55,"_56":57,"_58":59,"_39":31,"_28":29,"_61":62,"_63":48,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":65,"_72":73,"_74":11,"_75":29,"_76":77,"_82":11,"_83":84,"_88":29,"_89":90},"categories",[38,43],{"_39":40,"_41":42},"name","Networking","slug","networking",{"_39":44,"_41":45},"Security","security","content_types",[48],"image","date_registered","2026-02-12T13:16:36.881771Z","description","web application to monitor your local network and measure your Internet connection speed.","is_private","last_updated","2026-02-12T15:56:52.87419Z","last_modified","2026-02-12T16:08:53.045866Z","media_types",[60],"application/vnd.docker.container.image.v1+json","pull_count",1822,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n $\"NetTools$ \n

\n\n

NetTools

\n\n

\n Self-hosted network monitor and speed test\n

\n\n

\n GitHub •\n Quick Start •\n Features •\n Screenshots •\n Configuration\n

\n\n---\n\n## Description\n\n**NetTools** is a self-hosted web application to monitor your local network and measure your Internet connection speed. It provides a modern, responsive interface with three main modules: **Net Speed** (speed tests), **Net Alert** (device discovery) and **Net Check** (diagnostic tools).\n\n### Key Features\n\n- Automatic and manual speed tests with **Ookla Speedtest CLI**\n- Local network device discovery with **arp-scan** and **nmap**\n- Diagnostic tools: **Ping**, **Traceroute** and **NSLookup**\n- **Telegram** notifications when new devices are detected\n- Interactive charts with speed, latency and device history\n- Light, dark and auto themes\n- Customizable accent colors\n- Configurable timezone\n- Full REST API\n- No cloud dependencies - everything runs on your server\n\n---\n\n## Quick Start\n\n### Docker Run\n\n```bash\ndocker run -d \\\n --name nettools \\\n --network host \\\n -v nettools-data:/data \\\n -e TZ=Europe/Madrid \\\n -e NETTOOLS_PORT=8080 \\\n -e NETTOOLS_BACKEND_PORT=8000 \\\n --restart unless-stopped \\\n mbraut/nettools:latest\n```\n\n### Docker Compose\n\n```yaml\nservices:\n nettools:\n image: mbraut/nettools:latest\n container_name: nettools\n restart: unless-stopped\n network_mode: host\n volumes:\n - nettools-data:/data\n environment:\n - TZ=Europe/Madrid\n - NETTOOLS_PORT=8080 # Web UI port\n - NETTOOLS_BACKEND_PORT=8000 # API backend port (internal)\n\nvolumes:\n nettools-data:\n driver: local\n```\n\n```bash\ndocker compose up -d\n```\n\nAccess **http://your-server:8080**\n\n> **Note:** `network_mode: host` is required for `arp-scan` and `nmap` to discover devices on your local network. Without it, speed tests and diagnostic tools will work, but network scanning won't detect devices.\n\n---\n\n## Upgrade\n\n```bash\ndocker pull mbraut/nettools:latest\ndocker compose down\ndocker compose up -d\n```\n\n---\n\n## Screenshots\n\n### Net Speed\n![Net Speed](https://raw.githubusercontent.com/Enoret/Nettools/main/screenshots/NetSpeed.png)\n\n### Net Alert\n![Net Alert - Devices](https://raw.githubusercontent.com/Enoret/Nettools/main/screenshots/NetAlert0.png)\n![Net Alert - Details](https://raw.githubusercontent.com/Enoret/Nettools/main/screenshots/NetAlert1.png)\n\n### Net Check\n![Net Check](https://raw.githubusercontent.com/Enoret/Nettools/main/screenshots/NetCheck.png)\n\n### Settings\n![Settings](https://raw.githubusercontent.com/Enoret/Nettools/main/screenshots/Settings.png)\n\n---\n\n## Features\n\n### Net Speed\n- Manual speed test with server selection\n- Scheduled automatic tests (15 min - 24 h)\n- Speed history charts (download/upload)\n- Latency charts (ping/jitter)\n- Hourly speed averages\n- Recent tests table\n- Statistics: best download, best upload, best ping, total tests\n\n### Net Alert\n- Automatic local network scan (arp-scan + nmap)\n- New device detection\n- Manufacturer identification by MAC address\n- Device editing: name, type, location, description\n- Static IP or DHCP tagging\n- Filters: all, online, offline, new, saved, manual\n- Connected devices history (chart)\n- Telegram notifications for new devices\n\n### Net Check\n- **Ping**: single IP or all saved devices\n- **Traceroute**: route visualization with hop map and detailed table\n- **NSLookup / DNS**: A, AAAA, MX, NS, TXT, CNAME, SOA, PTR, SRV, ANY queries with DNS server selector\n\n### Settings\n- Automatic test frequency and network scan frequency\n- Network range (CIDR) and history retention\n- Timezone configuration\n- Telegram notifications (bot token + chat ID + connection test)\n- Color customization (accent, background, download, upload)\n- Data export (JSON)\n\n---\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Default | Description |\n|---|---|---|\n| `NETTOOLS_PORT` | `8080` | Web UI port |\n| `NETTOOLS_BACKEND_PORT` | `8000` | API backend port (internal) |\n| `NETTOOLS_DB_PATH` | `/data/nettools.db` | Database path |\n| `TZ` | `Europe/Madrid` | Container timezone |\n| `PYTHONUNBUFFERED` | `1` | Real-time logs |\n\n### Data Volume\n\n| Path | Contents |\n|---|---|\n| `/data/nettools.db` | SQLite database with tests, devices and settings |\n\nTo backup, simply copy the `/data/nettools.db` file.\n\n---\n\n## Telegram Setup\n\n1. Create a bot with [@BotFather](https://t.me/BotFather) on Telegram\n2. Copy the **Bot Token**\n3. Get your **Chat ID** (you can use [@userinfobot](https://t.me/userinfobot))\n4. In NetTools > Settings > Telegram Notifications:\n - Enable Telegram\n - Paste the Bot Token and Chat ID\n - Click \"Send Test\" to verify\n - Save settings\n\n---\n\n## Architecture\n\n```\n NETTOOLS_PORT (default 8080)\n |\n [ Nginx ]\n / \\\n Static /api/*\n (Frontend) |\n [ Uvicorn :NETTOOLS_BACKEND_PORT ]\n (FastAPI)\n |\n [ SQLite DB ]\n /data/nettools.db\n```\n\n| Component | Technology |\n|---|---|\n| Frontend | HTML5, CSS3, JavaScript (Vanilla) |\n| Charts | ApexCharts |\n| Backend | Python 3.12, FastAPI, Uvicorn |\n| Database | SQLite (WAL mode) |\n| Speed Test | Ookla Speedtest CLI |\n| Network Scan | arp-scan, nmap |\n| Notifications | Telegram Bot API |\n\n---\n\n## System Requirements\n\n| Resource | Minimum |\n|---|---|\n| CPU | 1 core |\n| RAM | 256 MB |\n| Disk | 100 MB + database |\n| Network | LAN access for scanning |\n\nCompatible with **amd64**, **arm64** (Raspberry Pi 4/5) and **armhf**.\n\n---\n\n## Source Code\n\nFull source code, manual installation guide and API documentation available on [GitHub](https://github.com/Enoret/Nettools).\n\n---\n\n## License\n\nMIT License\n\n---\n\nDeveloped by [bytebeat.es](https://bytebeat.es)","has_starred","hub_user","immutable_tags_settings",{"_78":11,"_79":80},"enabled","rules",[81],".*","is_automated","permissions",{"_85":17,"_86":11,"_87":11},"read","write","admin","user","storage_size",231268315,"orgData","recentTags",[94],{"_95":48,"_96":97,"_98":99,"_100":101,"_102":103,"_104":105,"_54":121,"_122":97,"_123":29,"_124":60,"_39":125,"_126":127,"_128":112,"_129":121,"_130":69,"_131":17},"content_type","creator",24437661,"digest","sha256:64bedda0130cc2f33639d1030303fa377ded4551bc9912057ac65d5bb4e43a9d","full_size",84090657,"id",1073504312,"images",[106],{"_107":108,"_98":99,"_109":110,"_111":112,"_113":114,"_115":116,"_117":110,"_118":-5,"_119":101,"_66":69,"_120":-5},"architecture","amd64","features","","last_pulled","2026-09-25T08:21:39.367812585Z","last_pushed","2026-02-12T15:56:51.441818704Z","os","linux","os_features","os_version","size","variant","2026-02-12T15:56:51.777813Z","last_updater","last_updater_username","media_type","latest","repository",30081314,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":143,"_152":153,"_139":162,"_163":11},{"_36":144,"_46":147,"_49":50,"_51":52,"_53":11,"_54":55,"_56":57,"_58":148,"_39":31,"_28":29,"_61":62,"_63":48,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":65,"_72":73,"_74":11,"_75":29,"_76":149,"_82":11,"_83":151,"_88":29,"_89":90},[145,146],{"_39":40,"_41":42},{"_39":44,"_41":45},[48],[60],{"_78":11,"_79":150},[81],{"_85":17,"_86":11,"_87":11},"tags",{"_154":67,"_155":-5,"_156":-5,"_157":158},"count","next","previous","results",[159],{"_95":48,"_96":97,"_98":99,"_100":101,"_102":103,"_104":160,"_54":121,"_122":97,"_123":29,"_124":60,"_39":125,"_126":127,"_128":112,"_129":121,"_130":69,"_131":17},[161],{"_107":108,"_98":99,"_109":110,"_111":112,"_113":114,"_115":116,"_117":110,"_118":-5,"_119":101,"_66":69,"_120":-5},[],"canDeleteTags","actionData","errors"]

mbraut/nettools

Tags for mbraut/nettools