Version
GET
/version
Display Installatron's version and license information.
Response
Response
HTTP status code describing the result of the request.
200
for
Success.
All other numbers represent errors which are described in the
errcode output below.
true
= Success.
false
= Failure.
↳
Internal build number of this version of Installatron.
(eg.
500
)
↳
true
= This server is licensed.
false
= This server is not licensed.
↳
IP address assigned to the license.
(eg.
123.123.123.123
)
↳
License expiration date (as a Unix timestamp).
(eg.
1234567890
)
↳
Installatron Plugin
Installatron as a plugin for supported webhosting control panels like cPanel/WHM, DirectAdmin, and Plesk.
Installatron Server
The standalone instance of Installatron.
↳
Installatron's version. Note that Installatron Plugin and Installatron Server have different versions.
↳
Newest version available on the select
version_channel.
(eg.
10.0.1
)
↳
Channel that Installatron is using.
release
Installatron's primary release.
edge
Version with all the latest bug fixes and features, and testing.
stable
Version that updates very rarely, and only with changes that have been well tested on release
.
none
The current version was specifically, manually installed and so won't be automatically updated by Installatron.
Full Examples
Example: Display Installatron's version and license information
Method: curl
$cpapi=https://{USER}:{PASS}@{SERVER_IP}:2083/3rdparty/installatron/index.cgi? # cpanel
#$cpapi=https://{USER}:{PASS}@{SERVER_IP}:2087/3rdparty/installatron/index.cgi? # whm
#$cpapi=https://{USER}:{PASS}@{SERVER_IP}:2222/CMD_PLUGINS/installatron/index.raw? # directadmin
curl -X POST $cpapi/version \
-H 'X-HTTP-Method-Override: GET' \
-H 'Accept: application/json'
Response: json
{
"status": 200,
"result": true,
"data": {
"product": "Installatron Plugin",
"version": "10.0.0",
"build": 500,
"version_channel": "release",
"version_available": "10.0.0-1",
"license": true,
"license_assignment": "123.123.123.123",
"license_expiry": 1234567890
}
}
Full Examples
Example: Display Installatron's version and license information
Method: json payload to curl
Response: json
{
"status": 200,
"result": true,
"data": {
"product": "Installatron Plugin",
"version": "10.0.0",
"build": 500,
"version_channel": "release",
"version_available": "10.0.0-1",
"license": true,
"license_assignment": "123.123.123.123",
"license_expiry": 1234567890
}
}
Full Examples
Example: Display Installatron's version and license information
Method: curl, php, and a user's login
<?php
$cpapi = 'https://{USER}:{PASS}@{SERVER_IP}:2083/3rdparty/installatron/index.cgi?'; // cpanel
//$cpapi = 'https://{USER}:{PASS}@{SERVER_IP}:2087/3rdparty/installatron/index.cgi?'; // whm
//$cpapi = 'https://{USER}:{PASS}@{SERVER_IP}:2222/CMD_PLUGINS/installatron/index.raw?'; // directadmin
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_URL => "$cpapi/version",
CURLOPT_HTTPHEADER => [
"X-HTTP-Method-Override: GET",
"Accept: application/json"
],
CURLOPT_RETURNTRANSFER => true
]);
if (( $response = curl_exec($ch) )=== false )
{
trigger_error(curl_error($ch));
}
curl_close($ch);
var_export(json_decode($response, true));
?>
Response: json
{
"status": 200,
"result": true,
"data": {
"product": "Installatron Plugin",
"version": "10.0.0",
"build": 500,
"version_channel": "release",
"version_available": "10.0.0-1",
"license": true,
"license_assignment": "123.123.123.123",
"license_expiry": 1234567890
}
}
Full Examples
Example: Display Installatron's version and license information
Method: cli
/usr/local/installatron/installatron \
--GET /version
Response: json
{
"status": 200,
"result": true,
"data": {
"product": "Installatron Plugin",
"version": "10.0.0",
"build": 500,
"version_channel": "release",
"version_available": "10.0.0-1",
"license": true,
"license_assignment": "123.123.123.123",
"license_expiry": 1234567890
}
}
Full Examples
Example: Display Installatron's version and license information
Method: json payload from cli
Response: json
{
"status": 200,
"result": true,
"data": {
"product": "Installatron Plugin",
"version": "10.0.0",
"build": 500,
"version_channel": "release",
"version_available": "10.0.0-1",
"license": true,
"license_assignment": "123.123.123.123",
"license_expiry": 1234567890
}
}