Go to file
Pepijn Over 52923336f3 changing markdown to rst; updating docs; adding docs build dir to gitignore; adding docs to release export 2014-04-10 19:57:36 +02:00
cron fixing fatal error after deleting server; 2014-03-28 16:52:04 +01:00
docs changing markdown to rst; updating docs; adding docs build dir to gitignore; adding docs to release export 2014-04-10 19:57:36 +02:00
src changing database version-check so if no changes have been made 2014-04-09 21:47:42 +02:00
static changing server-dropdown menu on view page to be inline 2014-04-05 16:04:25 +02:00
vendor/PHPMailer fixing fatal error after deleting server; 2014-03-28 16:52:04 +01:00
.gitattributes changing markdown to rst; updating docs; adding docs build dir to gitignore; adding docs to release export 2014-04-10 19:57:36 +02:00
.gitignore changing markdown to rst; updating docs; adding docs build dir to gitignore; adding docs to release export 2014-04-10 19:57:36 +02:00
CHANGELOG.rst changing markdown to rst; updating docs; adding docs build dir to gitignore; adding docs to release export 2014-04-10 19:57:36 +02:00
LICENSE moving changelog + license to root 2014-01-07 23:34:54 +01:00
Makefile changing markdown to rst; updating docs; adding docs build dir to gitignore; adding docs to release export 2014-04-10 19:57:36 +02:00
README.rst changing markdown to rst; updating docs; adding docs build dir to gitignore; adding docs to release export 2014-04-10 19:57:36 +02:00
config.php.sample adding gitattributes file for export excludes 2014-03-18 22:09:44 +01:00
index.php fixing fatal error after deleting server; 2014-03-28 16:52:04 +01:00
install.php fixing fatal error after deleting server; 2014-03-28 16:52:04 +01:00

README.rst

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

Version 3.1.0-dev

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 and SMS 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 range, 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 notification or text message (SMS).
The following SMS gateways are currently available:

* Mollie - <http://www.mollie.nl>
* Spryng - <http://www.spryng.nl>
* Inetworx - <http://www.inetworx.ch>
* Clickatell - <https://www.clickatell.com>
* Mosms - <http://www.mosms.com>
* Textmarketer - <http://www.textmarketer.co.uk>

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


Download
--------

The latest version can be downloaded from http://www.phpservermonitor.org/.


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

 * Web server
 * MySQL database
 * PHP 5.3.7+
 * PHP cURL package
 * PHP PDO mysql driver


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


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/.