PagerMon is an API driven client/server framework for parsing and displaying pager messages from multimon-ng.
It is built around POCSAG messages, but should easily support other message types as required.
The UI is built around a Node/Express/Angular/Bootstrap stack, while the client scripts are Node scripts that receive piped input.
- Capcode aliasing with colors and FontAwesome icons
- API driven extensible architecture
- Single user, multiple API keys
- SQLite or MySQL database backing
- Configurable via UI
- Pagination and searching
- Filtering by capcode or agency
- Duplicate message filtering
- Keyword highlighting
- WebSockets support - messages are delivered to clients in near realtime
- Pretty HTML5
- Native browner notifications
- Plugin Support - Current Plugins:
- Pushover near realtime muti-device notification service
- Prowl near realtime iOS notification service with Apple Watch support
- Telegram near realtime cloud based multi-device messaging
- Discord near realtime cloud based messaging service
- Gotify Self-Hosted messaging service
- Microsoft Teams Team colaboration platform
- Slack Team colabortation platform
- SMTP Email Support for conventional SMTP email notifications
- Regex Filters - Filter incoming messages via regex
- Regex Replace - Modify incoming messages via regex
- Message Repeat - Repeat incoming messages to another pagermon server
- May or may not contain cute puppies
- Multi-user support
- Postgres + MariaDB Support
- Horizontal scaling
- Enhanced message filtering
- Bootstrap 4 + Angular 2 support
- Enhanced alias control
- Non-sucky documentation
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
- Probably some other stuff
- nginx or some kind of reverse proxy for SSL offloading
Running the server
- Copy server/process-default.json to server/process.json and modify according to your environment
- Launch the app from the Terminal:
$ sudo apt-get install npm sqlite3 $ npm install npm@latest -g $ npm install pm2 -g $ cd server $ npm install $ export NODE_ENV=production $ pm2 start process.json
- To start on boot, let pm2 handle it:
$ sudo pm2 startup $ pm2 save
- You probably want to rotate logs, too:
$ pm2 install pm2-logrotate $ sudo pm2 logrotate -u user
- Now login via the website, default port is 3000, default credentials are 'admin' / 'changeme'
- Head to /admin, change your password, and generate some API keys
- Grab your API keys and drop them in the PagerMon client, then you're good to go!
Alternatively a production ready setup guide is available here https://github.com/pagermon/pagermon/wiki/Setup-Guide---Ubuntu-Server-with-NGINX-Reverse-Proxy-and-Let's-Encrypt-SSL-Certificate
- Build the container:
$ docker-compose build
- Run the container
$ docker-compose up
As daemon (
$ docker-compose up -d
- The database will be located relativ to your current working directory under
- The local port
3000will be forwarded to the docker container to port
- In case you would like to follow the logfile, run
docker logs -f pagermon(by
- To shutdown and remove the container, run
- If you make changes to the app for testing, you will need to re-build the image, run
docker-compose down && docker-compose up --build
- Follow Step 5 from Running the server__
General PagerMon support can be requested in the #support channel of the PagerMon discord server.
Click Here to join
Bugs and Feature requests can be logged via the GitHub issues page.
All are welcome to contribute. Contributors should submit a pull request with the requested changes.
CHANGELOG.md is to be updated on each pull request.
If a pull request is the first pull request since a release, then the version number should be bumped in
If a database schema change is required, this must be done using KnexJS Migration files. Insert Instructions for this here
See the list of contributors who participated in this project.
This project is licensed under The Unlicense - because fuck licenses. Do what you want with it. :>