mapik/watcher-nms

Watcher NMS

3.2.0 2025-11-13 13:00 UTC

Requires

• php: >=8.1
• cakedc/users: ^15.0.0
• cakephp/cakephp: ^5.0.6
• cakephp/migrations: ~4.6.0
• cakephp/plugin-installer: ^2.0
• composer/composer: ^2.6.6
• dereuromark/cakephp-geo: ^3.0.0
• geocoder-php/google-maps-provider: ^4.7.1
• league/oauth2-google: ^4.0
• mapik/audit-log: ^5.0
• mobiledetect/mobiledetectlib: ^4.8

Requires (Dev)

• cakedc/cakephp-phpstan: ^4.0.0
• cakephp/bake: ^3.0.0
• cakephp/cakephp-codesniffer: ^5.0
• cakephp/debug_kit: ^5.0.0
• josegonzalez/dotenv: ^4.0
• phpstan/extension-installer: ^1.1
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^10.1.0
• psalm/phar: ^6.0

Suggests

• cakephp/repl: Console tools for a REPL interface for CakePHP applications.
• dereuromark/cakephp-ide-helper: After baking your code, this keeps your annotations in sync with the code evolving from there on for maximum IDE and PHPStan/Psalm compatibility.
• markstory/asset_compress: An asset compression plugin which provides file concatenation and a flexible filter system for preprocessing and minification.
• phpstan/phpstan: PHPStan focuses on finding errors in your code without actually running it. It catches whole classes of bugs even before you write tests for the code.

GPL-2.0-only

• Martin Patočka

README

The framework source code can be found here: cakephp/cakephp.

Description

• Network Management System for evidence of access points, used devices, electricity meter readings and etc.
• can automatically load RouterOS devices (via SNMP) based on HTTP/S request from device itself - it describes own device type identifier (must be defined in system)
• it can automatically check interferences with Czech weather radar stations

Usage

Example of scheduler for RouterOS device:

/tool fetch url=("https://nms.watcher.domain/routeros-devices/configuration-script/{device-type-identifier}/" . [/system routerboard get serial-number] . "/watcher-config.rsc")
:delay 5
/file remove watcher-config.rsc

if you want also to change admin password to one generated by system based on serial number and SALT set in system, you can use this...

/tool fetch url=("https://nms.watcher.domain/routeros-devices/configuration-script/{device-type-identifier}/" . [/system routerboard get serial-number] . "/watcher-config.rsc")
/import watcher-config.rsc
:delay 5
/file remove watcher-config.rsc

Password can be found under View of this RouterOS Device

Installation

1. Download Composer or update composer self-update.
2. Run php composer.phar create-project --prefer-dist mapik/watcher-nms [app_name].

If Composer is installed globally, run

composer create-project --prefer-dist mapik/watcher-nms

In case you want to use a custom app dir name (e.g. /myapp/):

composer create-project --prefer-dist mapik/watcher-nms myapp

You can now either use your machine's webserver to view the default home page, or start up the built-in webserver with:

bin/cake server -p 8765

Then visit http://localhost:8765 to see the welcome page.

Configuration

Create and edit the config/.env or set system environment variables (eg. for Docker).

Layout

The app uses Milligram (v1.3) minimalist CSS framework.

License

Watcher NMS is licensed under the GNU Affero General Public License v3.0. Copyright (c) 2026 Martin Patočka

What this means

You are free to use, modify and run this software. If you modify it and make it available to others (including as a network service), you must also make your modifications available under the same license.