PortAlert Personal

TCP port monitoring software for Windows/Linux. PortAlert Personal checks your important services automatically, sends Email and Telegram alerts when a port is down, and sends a recovery message when the service returns to normal. No installation required. Edit configuration files and run it in ONE minute.

Overview

Offline License Email Alert Telegram Alert Recovery Notice IamAlive

PortAlert Personal is designed for simple and reliable monitoring of websites, servers, network devices, database ports, VPN endpoints, and internal services.

Recommended use cases: website monitoring, firewall rule monitoring, database port check, internal DNS / mail / VPN service monitoring, and small office server alerting.

Files Included

File	Description
`portalert`	Main monitoring program.
`license.dat`	Your offline license file.
`portalert_host.txt`	Host and port monitoring settings.
`portalert_email.txt`	SMTP and Telegram settings.
`portalert_log.txt`	Runtime log file created by the program.

Quick Start

Unzip and copy all files into one folder.
Edit portalert_host.txt to define the hosts and ports you want to monitor.
Edit portalert_email.txt to define your SMTP and Telegram settings.
Run portalert -check first to validate config format, then run portalert -test to confirm Email and Telegram delivery before enabling background mode.
Place your valid license.dat in the same folder.
Open Command Prompt in this folder and run portalert.

portalert
portalert -check
portalert -test
portalert -start
portalert -status
portalert -stop
portalert -licenseinfo
portalert -probe

Configuration format: key : "value"
Use : as separator. = is not supported by the recommended config standard.

Host Configuration

Edit portalert_host.txt.

interval : "15"
fast_retry_interval : "4"

host : "smartbooth.com"
port : "80"
description : "smartbooth web"
timeoutsec : "7"
alertcount : "3"

host : "590915.xyz"
port : "443"
description : "main website https"
timeoutsec : "7"
alertcount : "3"

Parameter Description

Parameter	Description
`interval`	Normal check interval in seconds.
`fast_retry_interval`	Shorter retry interval used when one or more monitored ports are in failure state.
`host`	Host name or IP address to monitor.
`port`	TCP port number to check.
`description`	Your note for this target.
`timeoutsec`	TCP connect timeout for each check.
`alertcount`	Number of consecutive failures before sending a DOWN alert.

Email and Telegram Configuration

Edit portalert_email.txt.

server : "smtp://smtp.gmail.com:587"
email : "your@gmail.com"
password : "your_app_password"
from : "your@gmail.com"
to : "admin1@hotmail.com,admin2@yahoo.com"
iamalive : "admin1@hotmail.com"
token : "your telegram bot token"
chat_id : "-123456789"

Parameter Description

Parameter	Description
`server`	SMTP server and port. Example: `smtp://smtp.gmail.com:587`
`email`	SMTP login account.
`password`	SMTP password or app password. The program can auto-convert it to encrypted format.
`from`	Sender email address.
`to`	Main alert recipients.
`iamalive`	Daily keep-alive recipient. Email to let you know program is up and running at midnight.
`token`	Telegram bot token.
`chat_id`	Telegram chat ID or group ID.

Gmail with App Password is recommended because it is easy to set up, fast, and reliable for sending alert emails.

License

PortAlert Personal uses an offline local license file named license.dat.

portalert -probe > probe.txt

Send the generated probe.txt to us. A matching license.dat will be issued for your machine.

portalert -licenseinfo

This command displays current license mode, customer, expire date, and machine matching result.

Alert Behavior

When a monitored port fails continuously and reaches alertcount, a DOWN alert is sent.
After a DOWN alert is sent, the internal failure counter is reset.
Before the service recovers, repeated DOWN alerts are not sent again and again.
When the service comes back, a RECOVERY alert is sent.
Daily IamAlive can be sent to confirm the program is still running at midnight.
When ports time out, additional 3 PING host response results are included in the alert text (helps identify network vs application issues)

Trial Mode Limits

Item	Trial Limit
Email alerts	2 per day
Telegram alerts	2 per day
IamAlive	1 per day
Monitoring targets	Maximum 2 hosts

Licensed mode removes the above Trial limits.

Command Reference

Command	Description
`portalert`	Run in foreground mode.
`portalert -start`	Start in background mode.
`portalert -stop`	Stop background process.
`portalert -status`	Check whether the monitor is running.
`portalert -check`	Validate config file format. Use this first to catch `=` and missing keys.
`portalert -test`	Send a test Email and Telegram alert to verify configuration.
`portalert -probe`	Print machine probe information.
`portalert -licenseinfo`	Show current license status.
`portalert -s`	Silent mode.
`portalert -h` / `portalert --help`	Show command help and usage summary.

Recommended command flow: edit config, run portalert -check and portalert -test, then use portalert -start for background monitoring.

Recommended Deployment

Install in a fixed folder such as PortAlert.
Keep portalert, license.dat, and config files in the same folder.
Use a stable SMTP account.
Test one invalid port first to verify Email and Telegram alerts are working correctly.

Troubleshooting

No Email Alert

Check SMTP server, account, password, and firewall rules.
Review portalert_log.txt.

No Telegram Alert

Check token and chat_id.
Ensure the bot has permission to message the target chat or group.

Still in Trial Mode

Confirm license.dat is in the same folder as portalert.
Run portalert -licenseinfo to check the reason.

Purchase

To purchase or renew your license, please visit:
https://www.smartbooth.com/purchase_lic.htm
To download
Windows Version Linux Version