Go to file
Petr Suchy af5334a073
Jabber (XMPP) notifications (#852)
Added Jabber/XMPP notifications.
Closes #829.
2020-04-19 15:31:40 +02:00
.github Added Paypal and bunq 2020-04-19 12:59:02 +02:00
cron cron update over the web via secret key (#888) 2020-04-19 14:19:33 +02:00
docs Jabber (XMPP) notifications (#852) 2020-04-19 15:31:40 +02:00
logs Jabber (XMPP) notifications (#852) 2020-04-19 15:31:40 +02:00
puphpet Removed default mysql port settings from files and left empty values (#403) 2018-08-09 19:16:20 +02:00
src Jabber (XMPP) notifications (#852) 2020-04-19 15:31:40 +02:00
.gitattributes Update .gitattributes 2016-05-19 01:22:07 -04:00
.gitignore Fixed fail to ping IPv6 #879 (#880) 2020-04-19 14:41:29 +02:00
.htaccess Added some basic pagespeed settings 2016-12-25 23:00:49 +01:00
CHANGELOG.rst Bumped version to 3.4.5 2019-09-30 17:59:24 +02:00
LICENSE moving changelog + license to root 2014-01-07 23:34:54 +01:00
Makefile File mode changed from 775 to 644 2020-02-09 18:04:26 +01:00
README.rst Jabber (XMPP) notifications (#852) 2020-04-19 15:31:40 +02:00
SECURITY.md Create SECURITY.md 2019-09-19 14:39:38 +02:00
Vagrantfile Adding Vagrantfile w/ puphpet configuration for easy development 2014-12-05 15:05:52 +01:00
composer.json Jabber (XMPP) notifications (#852) 2020-04-19 15:31:40 +02:00
composer.lock Jabber (XMPP) notifications (#852) 2020-04-19 15:31:40 +02:00
composer.phar Updated composer 2019-05-19 23:25:00 +02:00
config.php.sample cron update over the web via secret key (#888) 2020-04-19 14:19:33 +02:00
favicon.ico new favicon (with higher res available) 2014-08-01 11:38:16 +02:00
favicon.png Compressed images 2014-10-18 17:22:10 -04:00
index.php Implementing the PSR12 standard 2019-12-11 21:27:04 +01:00
install.php Implementing the PSR12 standard 2019-12-11 21:27:04 +01:00
manifest.json File mode changed from 775 to 644 2020-02-09 18:04:26 +01:00
phpservermon.png File mode changed from 775 to 644 2020-02-09 18:04:26 +01:00
service-worker.js Prevent loading main page if installed in subdirectory (fix #869) (#870) 2020-04-19 14:30:13 +02:00
updater.sh Set target shell 2019-12-12 17:07:21 +01:00

README.rst

PHP Server Monitor
==================

.. image:: https://badges.gitter.im/Join%20Chat.svg
   :alt: Join the chat at https://gitter.im/erickrf/nlpnet
   :target: https://gitter.im/phpservermon/phpservermon

Version 3.4.5

PHP Server Monitor is a script that checks whether your websites and servers are up and running.
It comes with a web based user interface where you can manage your services and websites,
and you can manage users for each server with a mobile number and email address.


Features:
---------

* Monitor services and websites (see below).
* Email, SMS, Pushover, Telegram and Jabber notifications.
* View history graphs of uptime and latency.
* User authentication with 2 levels (administrator and regular user).
* Logs of connection errors, outgoing emails and text messages.
* Easy cronjob implementation to automatically check your servers.

There are two different ways to monitor a server:

* Service

  A connection will be made to the entered ip or domain, on the given port.
  This way you can check if certain services on your machine are still running.
  To check your IMAP service for example, enter port 143.

* Website

  You can enter a link to a website, it will then use cURL to open the website and check the HTTP status code.
  If the HTTP status code is in the 4xx/5xx, it means an error occurred and the website is not accessible to the public.
  You can also set a regular expression to match for content on the page itself.
  If the regular expression returns no matches, the website is considered down.
  In both cases the script will return a "status offline", and will start sending out notifications.

Each server has its own settings regarding notification.
You can choose for email, text message (SMS), Pushover.net, Telegram and Jabber notifications.
The following SMS gateways are currently available:

* Clickatell - <https://www.clickatell.com>
* Inetworx - <https://www.inetworx.ch>
* Messagebird - <https://www.messagebird.com>
* Mosms - <https://www.mosms.com>
* Smsglobal - <https://smsglobal.com/>
* SMSit - <https://www.smsit.dk/>
* Spryng - <https://www.spryng.nl>
* Textmarketer - <https://www.textmarketer.co.uk>
* FreeVoipDeal - <https://www.freevoipdeal.com>
* Nexmo - <https://www.nexmo.com/>
* OctoPush - <https://www.octopush.com/>
* FreeMobile (FR) - <https://mobile.free.fr/>
* Twilio - <https://twilio.com>
* CM Telecom - <https://www.cm.com/>
* GatewayAPI - <https://gatewayapi.com/>
* SolutionsInfini - <https://solutionsinfini.com/>
* Plivo - <https://www.plivo.com/>
* Callr - <https://www.callr.com/>



Please note: for these gateways you will need an account with sufficient credits.


Download
--------

The latest version can be downloaded from https://github.com/phpservermon/phpservermon/releases.


Requirements
------------

* Web server
* MySQL database
* For PHP5: 5.5.9+
* For PHP7: 7.0.8+
* PHP cURL package
* PHP PDO mysql driver
* PHP-XML


Install
-------

Please see docs/install.rst.
In a nutshell: unzip, upload, run install.php, enjoy.

If you have downloaded the source from GitHub (and not a pre-built package), the dependencies are not included.
To be able to run an installation from the repo, you need to run the following command to install the dependencies::

     php composer.phar install

If you are familiar with Vagrant (https://www.vagrantup.com)::

     vagrant up

.. and browse to http://localhost:8080/psm/.


Documentation
-------------

The documentation is available in the docs folder or http://docs.phpservermonitor.org.


License
-------

PHP Server Monitor is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

PHP Server Monitor is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with PHP Server Monitor.  If not, see http://www.gnu.org/licenses/.

Docker
-------

PHPServerMonitor is now available on Docker : https://github.com/phpservermon/docker-phpservermonitor