1. Introduction
2. Provision Installatron Server
3. Interfacing with Installatron Server
3.1. Request Header
3.2. List available applications and application meta data
3.3. Installing an application
3.4. Import/migrate an existing installed application
3.5. List installed applications
3.6. List installed application backups
3.7. View/sync an installed application
3.8. Edit an installed application
3.9. Backup an installed application
3.10. Update an installed application
3.11. Clone an installed application
3.12. Restore an installed application backup
3.13. Delete an installed application backup
3.14. Import an installed application backup
3.15. Uninstall an installed application
3.16. List currently executing and recently completed tasks
3.17. Transferring a user into the Installatron Server GUI
3.17.1. Accessing the GUI as a website owner
3.17.2. Accessing the GUI as an administrative user or a reseller
3.17.3. Database management within the GUI
4. Advanced Usage
4.1. Define a website path on demand
4.2. Improve FTP file operation performance
4.3. Create/edit user data within the Installatron Server database
4.4. Remove user data from the Installatron Server database
Please reference the "What is Installatron Server?" page for an overview of what Installatron Server is: What is Installatron Server?
As outlined, there are two hosting options for Installatron Server:
Self-hosted (On Premise)
Cloud-hosted (On Installatron.com)
And three integration interfaces for Installatron Server:
HTTP API
Command-line API
Installatron Server GUI
Installatron Server is mostly managed through API calls. To use Installatron Server, you will need to be comfortable using API-driven systems.
In this document each Installatron Server integration interface will be explained in detail. The interfaces do not differ between Self-hosted and Cloud-hosted instances.
Follow these instructions to provision an instance of Installatron Server:
Input to the Installatron Server API can be formatted in JSON or simple URL encoded values.
Skip directly to the 3.17. Transferring a user into the Installatron Server GUI section to learn how to interface with the Installatron Server GUI.
The request header informs Installatron Server about a user. Every request to Installatron Server must include a header, including requests to transfer a user into the Installatron Server GUI.
| NAME | VALUE | ||||||||||||||||||||||||||||
| key | required The API authentication key. This is provided by Installatron when hosted as a service. Check the "key" value in /usr/local/installatron/etc/settings.ini for self-hosted instances. | ||||||||||||||||||||||||||||
| user | optional but recommended An alphanumeric value that the list of websites provided for the current session can be associated with. This argument will be used to index data and cannot change. | ||||||||||||||||||||||||||||
| reseller | optional An alphanumeric value that defines the hierarchical organization of the user provided. | ||||||||||||||||||||||||||||
| websites | required List of websites with each containing the below arguments. Note: Websites can only have one home directory so websites spread across multiple home directories will need separate website entries. See examples below.
|
{
"key": "8327b11a311aad5a8092d26d209c9e13",
"websites": [
{
"id": "ws124",
"path": "/var/www/vhosts/company.com",
"vhosts": {
"http://company.com": "httpdocs",
"http://www.company.com": "httpdocs"
},
"email": "user@mail.com",
"uid": 153,
"gid": 153
}
]
}
{
"key": "8327b11a311aad5a8092d26d209c9e13",
"websites": [
{
"id": "ws124",
"path": "ssh://user:pass@server120.host.com/var/www/vhosts/c/o/m/company.com",
"vhosts": {
"http://company.com": "public_html",
"http://www.company.com": "public_html",
"http://forum.company.com": "public_html/forum"
},
"email": "user@mail.com"
}
]
}
| NAME | VALUE |
| cmd | browser |
| key | required part of the Request Header that must be included with all API requests |
| websites | required for writing, optional for reading part of the Request Header that must be included with all API requests |
| user | required for writing, optional for reading part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| application | optional The ID of the application to list available versions of. This can be a single application or an array of multiple applications. By default the latest version of each application is listed. Listed versions are ordered correctly. |
| version | optional If application is set to one application, set this to only list the specific version. |
| from-version | optional If application is set to one application, set this to list all versions from specified version to the latest version. Each listed version includes a "upgrade_from" member which reveals whether an install at the specified version can upgraded to the listed version (values of "none" or "manual" mean it cannot). Listed versions are ordered correctly. |
| versions-available-from | optional If application is set to one application, instead of the usual output this will return two lists, "versions-available" and "versions-available-minor", each listing the versions upgradable to from the specified value. |
| language | optional The language application information should be returned in. For example, "en" for English or "zh_tw" for Chinese Traditional. If omitted, the defined website's default language or English is assumed. See: Available Installatron Translations. |
| NAME | VALUE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| result | true on success, or false on failure. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| message | Success or failure message. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| data | Table of release meta data.
|
curl https://installatron.com/apps \ -d "api=json" \ -d "cmd=browser" \ -d "application=wordpress" \ -d "version=4.9.7"
{
"result": true,
"message": "The task is complete.\n",
"data": [
{
"id": "wordpress_4.9.7",
"appid": "wordpress",
"version": "4.9.7",
"branch": "current",
"name": "WordPress",
"category": "Content Management",
"type": "blog",
"date": "2018-07-07",
"license": "open source",
"tags": [
"security"
],
"description": "WordPress is an open source blog application. WordPress forked from b2/cafelog in 2003, and WordPress Mu multiple website functionality has been integrated since 2010. Today WordPress is the most used blog application powering millions of blogs and being used by tens of millions of people every day.",
"authordescription": "WordPress is a personal publishing platform and blogging application with a focus on aesthetics, web standards, and usability.\r\n\r\nFeatures:\r\n* Additional pages allow you to manage non-blog content easily, so for example you could have a static \"About Me\" page.\r\n* A full theme system enables designing everything from the simplest blog to the most complicated webzine a piece of cake.\r\n* Changes made to templates and entries are reflected immediately on your site, with no need for regenerating static pages, and all generated HTML is fully compliant with W3C standards.\r\n* Trackback and Pingback standards fully supported.\r\n* Visitors can post comments on your blog entries, and commenting can be disabled on a per-post basis.\r\n* Spam protection eliminates comment spam from your blog.\r\n* User registration enables visitors to register and maintain profiles and leave authenticated comments on your blog, if enabled.\r\n* Password Protected Posts enables you to give passwords to individual posts to hide them from the public.\r\n* A full XML-RPC interface enables you to extend WordPress and use clients designed for other platforms like Zempt.\r\n* User groups enables up to 10 levels of users, with different levels having different (and configurable) privileges with regard to publishing, editing, options, and other users.\r\n* Bookmarklets make it easy to publish to your blog or add links to your blogroll with a minimum of effort.\r\n* Ping-O-Matic is supported, which means maximum exposure for your blog to search engines.",
"changelog": "WordPress 4.9.7 is a security and maintenance release.\r\n\r\nSecurity\r\n* Fixed a security problem where a user with the capability to edit and delete media files could potentially manipulate media metadata to attempt to delete files outside the uploads directory.\r\n\r\nHighlights\r\n* Taxonomy: Improve cache handling for term queries.\r\n* Posts, Post Types: Clear post password cookie when logging out.\r\n* Widgets: Allow basic HTML tags in sidebar descriptions on Widgets admin screen.\r\n* Community Events Dashboard: Always show the nearest WordCamp if one is coming up, even if there are multiple Meetups happening first.\r\n* Privacy: Make sure default privacy policy content does not cause a fatal error when flushing rewrite rules outside of the admin context.",
"upgrade": "minor",
"install": "auto",
"link_site": "http://wordpress.org",
"link_showcase": "http://wordpress.org/showcase",
"link_docs": "http://codex.wordpress.org",
"link_faq": "http://codex.wordpress.org/FAQ",
"link_support": "http://wordpress.org/support",
"link_changelog": "http://wordpress.org/news/2016/01/wordpress-4-4-1-security-and-maintenance-release/",
"link_admin": "wp-admin",
"link_installersupport": "https://installatron.com/tickets",
"requirements": {
"itron": "5.0.0-",
"diskspace": "40M",
"php": "5.2.4-",
"mysql": "5-",
"mysql_table_prefix": "wp_"
},
"languages": [
"ar",
"bg",
"ca",
"cs",
"da",
"de",
"el",
"en",
"en_au",
"en_ca",
"en_uk",
"es",
"et",
"fa",
"fi",
"fr",
"gl",
"he",
"hr",
"hu",
"it",
"is",
"ja",
"ko",
"lt",
"lv",
"nl",
"no",
"pl",
"pt",
"pt_br",
"ru",
"ro",
"sk",
"sr",
"sv",
"th",
"tr",
"uk",
"zh",
"zh_tw"
],
"fields": {
"version": {
"gettable": true,
"settable": false,
"label": "Version",
"text": "Select the version of WordPress to install.",
"sort_order": 0
},
"language": {
"label": "Language",
"text": "select a language",
"type": "select",
"gettable": true,
"settable": true,
"options": {
"ar": "Arabic",
"bg": "Bulgarian",
"ca": "Catalan",
"cs": "\u010cesky (Czech)",
"da": "Dansk",
"de": "Deutsch",
"el": "\u0395\u03bb\u03bb\u03b7\u03bd\u03b9\u03ba\u03ac (Greek)",
"en": "English",
"en_au": "en_au",
"en_ca": "English (Canada)",
"en_uk": "English (United Kingdom)",
"es": "Espa\u00f1ol (Spanish)",
"et": "Estonian",
"fa": "Persian",
"fi": "Suomi",
"fr": "Fran\u00e7ais",
"gl": "Gaelg",
"he": "Hebrew",
"hr": "Croatian",
"hu": "Magyar (Hungarian)",
"it": "Italiano",
"is": "Icelandic",
"ja": "Japanese",
"ko": "Korean",
"lt": "Lietuvi\u0173 (Lithuanian)",
"lv": "Latvian",
"nl": "Nederlands (Dutch)",
"no": "Norwegian",
"pl": "Polski",
"pt": "Portugu\u00eas (Portuguese)",
"pt_br": "Portugu\u00eas do Brasil",
"ru": "Russian",
"ro": "Rom\u00e2n\u0103",
"sk": "Slovak (Slovakian)",
"sr": "Serbian",
"sv": "Swedish",
"th": "Thai",
"tr": "T\u00fcrk\u00e7e (Turkish)",
"uk": "\u0423\u043a\u0440\u0430\u0457\u043d\u0441\u044c\u043a\u0430 (Ukrainian)",
"zh": "\u4e2d\u6587 (Chinese Simplified)",
"zh_tw": "\u4e2d\u6587(\u53f0\u7063) (Chinese Traditional)"
},
"sort_order": 1
},
"login": {
"label": "Administrator Username",
"text": "enter a username for the administrator user",
"type": "text",
"default": "admin",
"gettable": true,
"settable": true,
"sort_order": 2
},
"passwd": {
"label": "Administrator Password",
"text": "enter a password for the administrator user",
"type": "password",
"gettable": false,
"settable": true,
"sort_order": 3
},
"email": {
"label": "Administrator Email",
"text": "enter your email address",
"type": "text",
"gettable": true,
"settable": true,
"sort_order": 4
},
"sitetitle": {
"label": "Website Title",
"text": "enter title for the website",
"type": "text",
"gettable": true,
"settable": true,
"sort_order": 5
},
"sitetagline": {
"label": "Website Tagline",
"text": "enter tagline for the website",
"type": "text",
"gettable": true,
"settable": true,
"sort_order": 6
},
"twofactor": {
"type": "radio",
"value": "clef",
"label": "Two-Factor Authentication",
"options": {
"clef": "Two-factor authentication with Clef. (Recommended)",
"no": "Do not enable two-factor authentication."
},
"gettable": true,
"settable": true,
"sort_order": 7
},
"limitloginattempts": {
"type": "radio",
"value": "yes",
"label": "Limit Login Attempts",
"options": {
"yes": "Yes, limit failed login attempts for increased security. (Recommended)",
"no": "No, do not limit failed login attempts."
},
"gettable": true,
"settable": true,
"sort_order": 8
},
"multisite": {
"type": "radio",
"value": "no",
"label": "Enable Multi-site",
"options": {
"no": "No, do not enable. Multi-site can be enabled later within WordPress. (Recommended)",
"yes": "Yes, enable multi-site support for sub-directories of the selected install location."
},
"gettable": false,
"settable": false,
"sort_order": 9
}
},
"images": [
"button_wordpress.gif",
"icon_wordpress.png",
"icon175_wordpress.png",
"icon1752x_wordpress.png",
"icon64_wordpress.png",
"icon642x_wordpress.png",
"logo_wordpress.png",
"logo2x_wordpress.png",
"sc1_wordpress.png",
"sc10_wordpress.png",
"sc11_wordpress.png",
"sc12_wordpress.png",
"sc13_wordpress.png",
"sc14_wordpress.png",
"sc2_wordpress.png",
"sc3_wordpress.png",
"sc4_wordpress.png",
"sc5_wordpress.png",
"sc6_wordpress.png",
"sc7_wordpress.png",
"sc8_wordpress.png",
"sc9_wordpress.png",
"ss1_wordpress.png",
"ss2_wordpress.png",
"ss3_wordpress.png",
"ss4_wordpress.png",
"ss5_wordpress.png",
"x-ss2_wordpress.jpg"
]
}
]
}
| NAME | VALUE |
| cmd | install |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| application | required The ID of the application to be installed. For example, "wordpress" or "magento". Use the browser API to get a list of available applications. |
| version | optional, default is the latest compatible version The version of the application to be installed. |
| autoup | optional Change automatic update configuration. Values: 0 = Off (default); 1 = Update to minor versions only; 2 = Update to any version. |
| autoup_backup | optional Automatically create a backup and automatically restore the backup if the update fails. Values: 0 = Off; 1 = On (default). |
| url | required The URL to where the application should be installed. |
| url_ip | optional, default is the IP address resolved via DNS If the DNS will not resolve the provided url to the correct IP, use this argument to provide the correct IP. |
| db_host | required if the application requires a database, can be omitted if database automation is implemented The database server. |
| db_name | required if the application requires a database, can be omitted if database automation is implemented The pre-created database. |
| db_user | required if the application requires a database, can be omitted if database automation is implemented The pre-created database username. |
| db_pass | required if the application requires a database, can be omitted if database automation is implemented The pre-created database password. |
| db_prefix | optional, defaults to the prefix behavior configured at Installatron Admin > Features The prefix applied to database tables. |
| db_host_ip | optional, typically omitted If a different MySQL host value must be temporarily used to connect to the database, use this argument to provide the temporary address. Installed application files will be written with the "db_host" value, but Installatron will use "db_host_ip" while installing. |
| notification | optional List of email notifications to send for the installed application (each separated with a comma). Set a value of "all" to send all notifications (limited by those that are enabled in administration ยป Emails), or define an empty string to send no notifications.Available notifications:
A sample value could look like: "update_available,update,update_error" |
| background | optional When defined, the request will exit immediately and the task will be transferred to a background process after preliminary error checking. Use the tasks API to query the status of the background task. |
| dryrun | optional When defined, the request payload is validated but not executed. Dryrun set to a value of 2 checks everything, and dryrun set to a value of 1 just checks input so it can return faster. |
Optional automatic backup arguments:
| NAME | VALUE |
| autobk | optional Change automatic backup configuration. Values: custom = A custom schedule; (id) = The schedule identified by (id). |
| autobk_daily | optional The number of daily backups (for the "custom" option) |
| autobk_weekly | optional The number of weekly backups (for the "custom" option) |
| autobk_monthly | optional The number of monthly backups (for the "custom" option) |
Optional remote backup arguments:
| NAME | VALUE | ||||||||||||||||||||||||||||||
| bkloc | optional Set this to the URI to a backup location (which will be associated with the defined "user" for the session).Supported protocols:
Examples:
|
Further optional arguments that depend on the application (get a full list of fields available for a specific application/version using the browser API):
| NAME | VALUE |
| language | optional, default is the website's default language or English The language of the application to be installed. For example, "en" for English or "zh_tw" for Chinese Traditional. Use the browser API to get a list of available languages for the installed application. |
| login | optional, default is randomly generated value The username for the installed application's administrative account. |
| passwd | optional, default is randomly generated value The password for the installed application's administrative account. If omitted, a randomized password is assumed. |
| sitetitle | optional, default is "My blog" or similar The site title value for the installed application. |
| content | optional, default is "yes" Set to "yes" for the sample/demo template.Set to "no" for the blank install template. Set to the ID of the template for a different template. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Table of installed application information. |
| task | Table of task information if executed as a background process. |
curl https://installatron.com/server/v1 \ -d "key=8327b11a311aad5a8092d26d209c9e13" \ -d "websites[0][id]=ws124" \ -d "websites[0][email]=user@mail.com" \ -d "websites[0][path]=ftp://website124:password@12.24.36.22" \ -d "websites[0][vhosts][http://company.com]=httpdocs" \ -d "websites[0][vhosts][http://www.company.com]=httpdocs" \ -d "cmd=install" \ -d "application=wordpress" \ -d "url=http://company.com" \ -d "db_name=db123" \ -d "db_user=db123" \ -d "db_pass=sdfsdf1" \ -d "db_host=localhost"
{
"result": true,
"message": "",
"data": {
"id": "3reqf1iduigw0kogk8skgcsoc",
"installer": "wordpress",
"version": "3.6.1",
"language": "en",
"time": "1380560311",
"agent": "4.0.0",
"owner": "dev1",
"path": "/home/dev1/public_html",
"path-created": "1",
"url": "http://company.com",
"url-domain": "company.com",
"db-host": "localhost",
"db-type": "mysql",
"db-name": "db123",
"db-user": "db123",
"db-pass": "sdfsdf1",
"db-prefix": "wp_",
"title": "My blog",
"list-files": [
"index.php",
"license.txt",
".htaccess",
"wp-activate.php",
"wp-admin",
"wp-app.php",
"wp-itapi.php",
"wp-blog-header.php",
"wp-comments-post.php",
"wp-config-sample.php",
"wp-config.php",
"wp-content",
"wp-cron.php",
"wp-includes",
"wp-links-opml.php",
"wp-load.php",
"wp-login.php",
"wp-mail.php",
"wp-settings.php",
"wp-signup.php",
"wp-trackback.php",
"xmlrpc.php"
],
"list-tables": [
"wp_commentmeta",
"wp_comments",
"wp_links",
"wp_options",
"wp_postmeta",
"wp_posts",
"wp_term_relationships",
"wp_term_taxonomy",
"wp_terms",
"wp_usermeta",
"wp_users"
],
"autoup": "1",
"bkloc": "local",
"autobk": "0",
"cf-login": "admin",
"cf-email": "support@installatron.com",
"cf-sitetitle": "My blog",
"cf-sitetagline": "Just another WordPress site",
"cf-limitloginattempts": "yes",
"cache-tables": "87828",
"link-admin": "wp-admin",
"cache-files": "16105472",
"cache-time": "1380560313",
"cache-numbackups": "0"
}
}
echo '{
"key": "8327b11a311aad5a8092d26d209c9e13",
"websites":
[{
"id":"ws124",
"path":"/var/www/vhosts/company.com",
"vhosts":{
"http://company.com":"httpdocs",
"http://www.company.com":"httpdocs"
},
"email":"user@mail.com",
"uid":153,
"gid":153
}],
"cmd":"install",
"application":"wordpress",
"url":"http://company.com/blog",
"db_name":"db123",
"db_user":"db123",
"db_pass":"sdfsdf1",
"db_host":"localhost"
}' | /usr/local/installatron/installatron
curl https://installatron.com/server/v1 \ -d "key=8327b11a311aad5a8092d26d209c9e13" \ -d "websites[0][id]=ws124" \ -d "websites[0][email]=user@mail.com" \ -d "websites[0][path]=ftp://website124:password@12.24.36.22" \ -d "websites[0][vhosts][http://company.com]=httpdocs" \ -d "websites[0][vhosts][http://www.company.com]=httpdocs" \ -d "cmd=install" \ -d "application=wordpress" \ -d "url=http://company.com/blog" \ -d "db_name=db123" \ -d "db_user=db123" \ -d "db_pass=sdfsdf1" \ -d "db_host=localhost"
<?php
$query = array(
/* these values define the request header: */
"key" => "8327b11a311aad5a8092d26d209c9e13",
"websites" => array(
array(
"id" => "ws124",
"path" => "ftp://".urlencode("website124").":".urlencode("password")."@12.24.36.22",
"vhosts" => array(
"http://company.com" => "httpdocs",
"http://www.company.com" => "httpdocs",
"https://company.com" => "httpsdocs",
"https://www.company.com" => "httpsdocs",
),
"email" => "user@mail.com",
)
),
/* these values define the request body: */
"cmd" => "install",
"application" => "wordpress",
"url" => "http://company.com/blog",
"db_name" => "db123",
"db_user" => "db123",
"db_pass" => "sdfsdf1",
"db_host" => "localhost",
);
$ch = curl_init("https://installatron.com/server/v1");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($query));
$reply = curl_exec($ch);
if ( $reply === false )
{
echo "An error occurred: ".curl_error($ch);
return;
}
$reply = json_decode($reply,true);
if ( $reply["result"] === false )
{
echo "An error occurred: ".$reply["message"];
return;
}
echo "Success! ".$reply["message"];
Installed applications can be imported from hosted websites or migrated from remote web hosting servers. When migrating, include the source_url and source_ftu arguments.
As of Installatron Server 3.0, current database information for the installed application is always automatically detected.
| NAME | VALUE |
| cmd | import |
| key | required part of the Request Header that must be included with all API requests |
| user | required/optional Import the application to a specific user on the control panel. This field is required if the import command is performed as the server administrator or a reseller but is optional if performed as a user. |
| application | required The ID of the application to be imported or migrated. For example, "wordpress" or "magento". See: List of applications. |
| version | optional, defaults to the automatically-detected version The version of the application to be imported. If omitted, the version is automatically detected. |
| url | required For a local Import this is the URL to where the application is current located. For a remote Import (a Migration) this is the destination URL where the copy of the source application will be constructed. |
| url_ip | optional, default is the IP address resolved via DNS If DNS cannot resolve the provided url to the correct IP, use this argument to provide the correct IP. |
| source_url | required if migrating an installed application from a remote server If migrating an installed application from a remote server, include this argument to provide the source installed application URL.For example, "http://website.com/wordpress". |
| source_ftu | required if migrating an installed application from a remote server If migrating an installed application from a remote server, include this argument to provide the source installed application account information.Supported filesystem protocols:
Specifically for WordPress only, Installatron Server also provides the option to migrate an installation using only the WordPress administrative username and password. No filesystem protocol is required in this case, just the WordPress administrative username and password. To use this option, provide the username and password in this format: app://username:password Examples:
|
| source_ftu_key | optional, path to a SSH key file If migrating an installed application from a remote server over SSH or SFTP, the SSH/SFTP password can be left blank and an optional SSH key file can be defined here. |
| source_url_ip | optional, default is the IP address resolved via DNS If migrating an installed application from a remote server, include this argument to provide Installatron the IP address that Installatron should use for the source server. Providing this value means that Installatron will not need to perform DNS lookup on the source domain. |
| background | optional When defined, the request will exit immediately and the task will be transferred to a background process after preliminary error checking. Use the tasks API to query the status of the background task. |
| dryrun | optional When defined, the request payload is validated but not executed. Dryrun set to a value of 2 checks everything, and dryrun set to a value of 1 just checks input so it can return faster. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Table of installed application information. |
| NAME | VALUE |
| invalid_worker_plugin_upload | Upload of the worker plugin has failed. This can occur due to an interrupted connection, plugin incompatiblity, or WAF (Web Application Firewall) blocking the request. Try the migration again, but if the same error occurs then the server may be incompatible. |
| invalid_worker_plugin | The worker plugin has failed after upload. This can occur due to an interrupted connection, plugin incompatiblity, or WAF (Web Application Firewall) blocking the request. Try the migration again, but if the same error occurs then the server may be incompatible. |
| invalid_connection_id | The worker plugin is locked to a different Installatron Server instance. To unlock it, either Reset the worker plugin from the WordPress Plugins page and then try the migration again, or wait 15 minutes for the connection to expire and then try the migration again. |
| invalid_signature | An invalid RSA signature was provided to the worker plugin from Installatron Server. Try the migration again. |
| cannot_find_uid | The WordPress username provided was invalid. |
| invalid_password | The WordPress password provided was invalid. |
{
"result": true,
"message": "",
"data": {
"id": "3reqf1iduigw0kogk8skgcsoc",
"installer": "wordpress",
"version": "3.6.1",
"language": "en",
"time": "1380560311",
"agent": "4.0.0",
"owner": "dev1",
"path": "/home/dev1/public_html/test",
"path-created": "1",
"url": "http://dev1.dev-is4.installatron.com/test",
"url-domain": "dev1.dev-is4.installatron.com",
"db-host": "localhost",
"db-type": "mysql",
"db-name": "dev1_wp1",
"db-user": "dev1_wp1",
"db-pass": "Y[|BrJ2PAy]@0",
"db-prefix": "wp_",
"title": "My blog",
"list-files": [
"index.php",
"license.txt",
".htaccess",
"wp-activate.php",
"wp-admin",
"wp-app.php",
"wp-itapi.php",
"wp-blog-header.php",
"wp-comments-post.php",
"wp-config-sample.php",
"wp-config.php",
"wp-content",
"wp-cron.php",
"wp-includes",
"wp-links-opml.php",
"wp-load.php",
"wp-login.php",
"wp-mail.php",
"wp-settings.php",
"wp-signup.php",
"wp-trackback.php",
"xmlrpc.php"
],
"list-tables": [
"wp_commentmeta",
"wp_comments",
"wp_links",
"wp_options",
"wp_postmeta",
"wp_posts",
"wp_term_relationships",
"wp_term_taxonomy",
"wp_terms",
"wp_usermeta",
"wp_users"
],
"autoup": "1",
"bkloc": "local",
"autobk": "0",
"cf-login": "admin",
"cf-email": "support@installatron.com",
"cf-sitetitle": "My blog",
"cf-sitetagline": "Just another WordPress site",
"cf-limitloginattempts": "yes",
"cache-tables": "87828",
"link-admin": "wp-admin",
"cache-files": "16105472",
"cache-time": "1380560313",
"cache-numbackups": "0"
}
}
{
"result": false,
"message": "Error: Could not connect to the web hosting server. Please try again in a couple of minutes. If the problem persists please double check the provided connection. Technical Error: invalid_worker_plugin_upload",
"errcode": "invalid_worker_plugin_upload",
"data": null
}
| NAME | VALUE |
| cmd | installs |
| key | required part of the Request Header that must be included with all API requests |
| user | optional View the installs of a specific user on the control panel. The default is the control panel administrator. |
| q | optional Search installed application with a query. This searches the title, url, id, installer, and owner fields. |
| id | optional Display a specific installed application by ID. |
| filter-version-available | optional When set equal to "yes", only installed applications that have any new version upgrades available will be listed. |
| filter-version-available-minor | optional When set equal to "yes", only installed applications that have new minor version upgrades available will be listed. |
| filter-ownedaccounts | optional Add this parameter (as; filter-ownedaccounts=) if you wish to also see the installs of accounts owned by this user. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Detailed list of matched installed applications. |
{
"result": true,
"message": "",
"data": [
{
"id": "3reqf1iduigw0kogk8skgcsoc",
"installer": "wordpress",
"version": "3.6.1",
"language": "en",
"time": "1380560311",
"agent": "4.0.0",
"owner": "dev1",
"path": "/home/dev1/public_html/test",
"path-created": "1",
"url": "http://dev1.dev-is4.installatron.com/test",
"url-domain": "dev1.dev-is4.installatron.com",
"db-host": "localhost",
"db-type": "mysql",
"db-name": "dev1_wp1",
"db-user": "dev1_wp1",
"db-pass": "Y[|BrJ2PAy]@0",
"db-prefix": "wp_",
"title": "My blog",
"list-files": [
"index.php",
"license.txt",
".htaccess",
"wp-activate.php",
"wp-admin",
"wp-app.php",
"wp-itapi.php",
"wp-blog-header.php",
"wp-comments-post.php",
"wp-config-sample.php",
"wp-config.php",
"wp-content",
"wp-cron.php",
"wp-includes",
"wp-links-opml.php",
"wp-load.php",
"wp-login.php",
"wp-mail.php",
"wp-settings.php",
"wp-signup.php",
"wp-trackback.php",
"xmlrpc.php"
],
"list-tables": [
"wp_commentmeta",
"wp_comments",
"wp_links",
"wp_options",
"wp_postmeta",
"wp_posts",
"wp_term_relationships",
"wp_term_taxonomy",
"wp_terms",
"wp_usermeta",
"wp_users"
],
"autoup": "1",
"bkloc": "local",
"autobk": "0",
"cf-login": "admin",
"cf-email": "support@installatron.com",
"cf-sitetitle": "My blog",
"cf-sitetagline": "Just another WordPress site",
"cf-limitloginattempts": "yes",
"cache-tables": "87828",
"link-admin": "wp-admin",
"cache-files": "16105472",
"cache-time": "1380560313",
"cache-numbackups": "0"
},
{
"id": "gk8skgcsocreqf1d4uigwi0ko",
"installer": "wordpress",
"version": "3.6.1",
"language": "en",
"time": "1380560300",
"agent": "4.0.0",
"owner": "dev1",
"path": "/home/dev1/public_html/test2",
"path-created": "1",
"url": "http://dev1.dev-is4.installatron.com/test2",
"url-domain": "dev1.dev-is4.installatron.com",
"db-host": "localhost",
"db-type": "mysql",
"db-name": "dev1_wp1",
"db-user": "dev1_wp1",
"db-pass": "c0BrJY[y]@2PA",
"db-prefix": "wp_",
"title": "My blog",
"list-files": [
"index.php",
"license.txt",
".htaccess",
"wp-activate.php",
"wp-admin",
"wp-app.php",
"wp-itapi.php",
"wp-blog-header.php",
"wp-comments-post.php",
"wp-config-sample.php",
"wp-config.php",
"wp-content",
"wp-cron.php",
"wp-includes",
"wp-links-opml.php",
"wp-load.php",
"wp-login.php",
"wp-mail.php",
"wp-settings.php",
"wp-signup.php",
"wp-trackback.php",
"xmlrpc.php"
],
"list-tables": [
"wp_commentmeta",
"wp_comments",
"wp_links",
"wp_options",
"wp_postmeta",
"wp_posts",
"wp_term_relationships",
"wp_term_taxonomy",
"wp_terms",
"wp_usermeta",
"wp_users"
],
"autoup": "1",
"bkloc": "local",
"autobk": "0",
"cf-login": "admin",
"cf-email": "support@installatron.com",
"cf-sitetitle": "My blog",
"cf-sitetagline": "Just another WordPress site",
"cf-limitloginattempts": "yes",
"cache-tables": "87828",
"link-admin": "wp-admin",
"cache-files": "16105472",
"cache-time": "1380560313",
"cache-numbackups": "0"
}
]
}
| NAME | VALUE |
| cmd | backups |
| key | required part of the Request Header that must be included with all API requests |
| user | optional View the backups of a specific user on the control panel. The default is the control panel administrator. |
| q | optional Search installed application backups with a query. This searches the title, url, id, installer, and owner fields. |
| pid | optional Display only installed application backups that belong to this installed application ID. This can be used in conjunction with the "q" argument. (added with version 4.1.5) |
| id | optional Display a specific installed application backup by ID. |
| filter-ownedaccounts | optional Add this parameter (as; filter-ownedaccounts=) if you wish to also see the backups of accounts owned by this user. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Detailed list of matched installed application backups. |
{
"result": true,
"message": "",
"data": [
{
"id": "aga40vngcy888kg44coogkgwk",
"file": "/home/dev1/.appdata/backups/aga40vngcy888kg44coogkgwk",
"installer": "zurmo",
"version": "2.0.21",
"language": "en",
"time": "1376660774",
"agent": "9.0.0",
"owner": "dev1",
"path": "/home/dev1/domains/dev1.dev-is4.installatron.com/public_html/crmtest02",
"path-created": "1",
"url": "http://dev1.dev-is4.installatron.com/crmtest02",
"url-domain": "dev1.dev-is4.installatron.com",
"db-host": "localhost",
"db-type": "mysql",
"db-name": "dev1_zurm41",
"db-user": "dev1_zurm41",
"db-pass": "S@qXksiex|^*3",
"list-files": [
"app/protected/config/perInstance.php",
".htaccess",
"app",
"documentation",
"index.php",
"License.txt",
"redbean",
"yii"
],
"list-tables": [
"account",
"account_read",
"activelanguage",
"activity",
"activity_item",
"address",
"auditevent",
"autoresponder",
"autoresponderitem",
"autoresponderitemactivity",
"basecustomfield",
"bytimeworkflowinqueue",
"calculatedderivedattributemetadata",
"comment",
"contact",
"contactstate",
"contact_opportunity",
"contact_read",
"conversation",
"conversationparticipant",
"conversation_item",
"conversation_read",
"currency",
"currencyvalue",
"customfield",
"customfielddata",
"dashboard",
"derivedattributemetadata",
"dropdowndependencyderivedattributemetadata",
"email",
"emailaccount",
"emailbox",
"emailfolder",
"emailmessage",
"emailmessagecontent",
"emailmessageitemactivity",
"emailmessagerecipient",
"emailmessagesender",
"emailmessagesenderror",
"emailmessage_read",
"emailsignature",
"emailtemplate",
"emailtemplate_read",
"exportfilemodel",
"exportitem",
"filecontent",
"filemodel",
"gamebadge",
"gamelevel",
"gamenotification",
"gamepoint",
"gamepointtransaction",
"gamescore",
"globalmetadata",
"import",
"item",
"jobinprocess",
"joblog",
"marketinglist",
"marketinglistmember",
"marketinglist_read",
"meeting",
"meeting_read",
"messagesource",
"messagetranslation",
"mission",
"mission_read",
"namedsecurableitem",
"note",
"note_read",
"notification",
"notificationmessage",
"opportunity",
"opportunity_read",
"ownedsecurableitem",
"permission",
"permitable",
"person",
"personwhohavenotreadlatest",
"perusermetadata",
"policy",
"portlet",
"role",
"savedreport",
"savedreport_read",
"savedsearch",
"savedworkflow",
"securableitem",
"socialitem",
"socialitem_read",
"task",
"task_read",
"workflowmessageinqueue",
"_group",
"_group__user",
"_right",
"_user",
"__role_children_cache"
],
"autoup": "1",
"bkloc": "local",
"autobk": "0",
"title": "My Zurmo (3)",
"cf-email": "admin@www1.installatron.com",
"version-available": "2.2.1",
"version-available-minor": "2.0.22",
"version-autouped": "2.0.22",
"version-notified": "2.0.22",
"cf-login": "super",
"cf-passwd": "",
"backup-schedule": "1f9d83723e594ba1826adf517f869067",
"backup-install": "ewr255xcvs0k0w0gwso80gck",
"backup-location": "local",
"backup-time": "1377427408",
"backup-filename": "app_testing-installatron-com_My-Zurmo-3_2013-08-25_05-43-28.tar.gz",
"cache-time": "1377427408",
"cache-archive": "13836288"
}
]
}
| NAME | VALUE |
| cmd | view |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| id | required The ID of the installed application to be synced and displayed. |
| addons | optional Set to a value of 1 to include a list of installed plugins and themes in the result. (WordPress only) |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Application details, similar to the "installs" API return value. |
{
"result": true,
"message": "The task is complete.\n",
"data": {
"id": "4yhfygnd10ws0wc8skck444s",
"file": "/home/dev1/.appdata/current/4yhfygnd10ws0wc8skck444s",
"installer": "wordpress",
"version": "3.5.2",
"language": "en",
"time": "1378531720",
"agent": "9.0.0",
"owner": "itwww1su",
"path": "/home/dev1/domains/dev1.dev-is4.installatron.com/public_html/pppoposdopsd3",
"path-created": "1",
"url": "http://dev1.dev-is4.installatron.com/pppoposdopsd3",
"url-domain": "dev1.dev-is4.installatron.com",
"db-host": "localhost",
"db-type": "mysql",
"db-name": "dev1_wp3",
"db-user": "dev1_wp3",
"db-pass": "K@C^l2eMn6##7",
"db-prefix": "wp_",
"title": "My blog (3)",
"list-files": [
"index.php",
"license.txt",
".htaccess",
"wp-activate.php",
"wp-admin",
"wp-app.php",
"wp-blog-header.php",
"wp-comments-post.php",
"wp-config-sample.php",
"wp-config.php",
"wp-content",
"wp-cron.php",
"wp-includes",
"wp-links-opml.php",
"wp-load.php",
"wp-login.php",
"wp-mail.php",
"wp-settings.php",
"wp-signup.php",
"wp-trackback.php",
"xmlrpc.php"
],
"list-tables": [
"wp_commentmeta",
"wp_comments",
"wp_links",
"wp_options",
"wp_postmeta",
"wp_posts",
"wp_term_relationships",
"wp_term_taxonomy",
"wp_terms",
"wp_usermeta",
"wp_users"
],
"autoup": "1",
"bkloc": "local",
"autobk": "0",
"cf-login": "admin",
"cf-email": "admin@www1.installatron.com",
"cf-sitetitle": "My blog",
"cf-sitetagline": "Just another WordPress site",
"cache-tables": "606208",
"link-admin": "wp-admin",
"cache-files": "15630336",
"cache-time": "1380090388",
"cache-numbackups": "9",
"cf-passwd": "",
"version-autouped": "3.5.2",
"version-notified": "3.6.1",
"time-updated": "1378553088",
"cf-limitloginattempts": "no",
"plugin-updates-available": 1,
"plugin-updates-notified": "a:1:{i:0;s:25:\"akismet/akismet.php-2.5.9\";}",
"theme-updates-notified": "a:2:{i:0;s:16:\"twentyeleven-1.6\";i:1;s:16:\"twentytwelve-1.2\";}",
"autoup-plugins": "0",
"autoup-themes": "0",
"backup-time": "1379379513",
"version-available": "3.6.1",
"list-notification": [
"clone",
"clone_error",
"backup",
"backup_error",
"restore",
"restore_error",
"update_available",
"update",
"update_error"
],
"cache-preview": "5061",
"theme-updates-available": null,
"list-plugins": {
"akismet/akismet.php": {
"Name": "Akismet",
"PluginURI": "http://akismet.com/?return=true",
"Version": "2.5.8",
"Description": "Used by millions, Akismet is quite possibly the best way in the world to <strong>protect your blog from comment and trackback spam</strong>. It keeps your site protected from spam even while you sleep. To get started: 1) Click the \"Activate\" link to the left of this description, 2) <a href=\"http://akismet.com/get/?return=true\">Sign up for an Akismet API key</a>, and 3) Go to your Akismet configuration page, and save your API key.",
"Author": "Automattic",
"AuthorURI": "http://automattic.com/wordpress-plugins/",
"TextDomain": "",
"DomainPath": "",
"Network": false,
"Title": "Akismet",
"AuthorName": "Automattic",
"_ud": {
"id": "15",
"slug": "akismet",
"new_version": "2.5.9",
"url": "http://wordpress.org/plugins/akismet/",
"package": "http://downloads.wordpress.org/plugin/akismet.2.5.9.zip"
}
},
"hello.php": {
"Name": "Hello Dolly",
"PluginURI": "http://wordpress.org/extend/plugins/hello-dolly/",
"Version": "1.6",
"Description": "This is not just a plugin, it symbolizes the hope and enthusiasm of an entire generation summed up in two words sung most famously by Louis Armstrong: Hello, Dolly. When activated you will randomly see a lyric from <cite>Hello, Dolly</cite> in the upper right of your admin screen on every page.",
"Author": "Matt Mullenweg",
"AuthorURI": "http://ma.tt/",
"TextDomain": "",
"DomainPath": "",
"Network": false,
"Title": "Hello Dolly",
"AuthorName": "Matt Mullenweg"
}
},
"list-themes": {
"twentyeleven": {
"Name": "Twenty Eleven",
"Title": "Twenty Eleven",
"Version": "1.6",
"Author": "the WordPress team",
"Author URI": "http://wordpress.org/",
"Template": "twentyeleven",
"Stylesheet": "twentyeleven"
},
"twentytwelve": {
"Name": "Twenty Twelve",
"Title": "Twenty Twelve",
"Version": "1.2",
"Author": "the WordPress team",
"Author URI": "http://wordpress.org/",
"Template": "twentytwelve",
"Stylesheet": "twentytwelve"
}
}
}
}
Updates the specified installed application by setting the values of the parameters passed. Any parameters not provided will be left unchanged. For example, if you pass the language parameter, that becomes the install's active language.
| NAME | VALUE |
| cmd | edit |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| id | required The ID of the installed application to be edited. |
| url | optional, defaults to the existing value The URL to the installed application. |
| autoup | optional, defaults to the existing value Change automatic update configuration. Values: 0 = Off; 1 = Update to minor versions only; 2 = Update to any version. |
| autoup_backup | optional, defaults to the existing value Automatically create a backup and automatically restore the backup if the update fails. Values: 0 = Off; 1 = On (default). |
| notification | optional, defaults to the existing value List of email notifications to send for the installed application (each separated with a comma). Omit this argument to retain the current value, set a value of "all" to send all notifications (limited by those that are enabled in administration ยป Emails), or define an empty string to send no notifications.Available notifications:
A sample value could look like: "update_available,update,update_error" |
| db_host | optional, defaults to the existing value The server that hosts the installed application's database. |
| db_name | optional, defaults to the existing value The name of the installed application's database. |
| db_user | optional, defaults to the existing value The database username used to connect to the installed application's database. |
| db_pass | optional, defaults to the existing value The database username password. |
| db_prefix | optional, defaults to the existing value The prefix each database table begins with, including trailing underscore (if any). |
Automatic backup arguments:
| NAME | VALUE |
| autobk | optional, defaults to the existing value Change automatic backup configuration. Values: custom = A custom schedule; (id) = The schedule identified by (id). |
| autobk_daily | optional, defaults to the existing value The number of daily backups (for the "custom" option) |
| autobk_weekly | optional, defaults to the existing value The number of weekly backups (for the "custom" option) |
| autobk_monthly | optional, defaults to the existing value The number of monthly backups (for the "custom" option) |
Remote backup arguments:
| NAME | VALUE | ||||||||||||||||||||||||||||||
| bkloc | optional, defaults to the existing value Set this to the URI to a backup location (which will be associated with the defined "user" for the session).Supported protocols:
Examples:
|
Further arguments that depend on the application (get a full list of fields available for a specific application/version using the browser API):
| NAME | VALUE |
| language | optional, defaults to the existing value The language of the installed application. Use the browser API to get a list of available languages for the installed application. |
| login | optional, defaults to the existing value The username of the installed application's administrative account. |
| passwd | optional, defaults to the existing value The password of the installed application's administrative account. |
optional, defaults to the existing value The email of the installed application's administrative account. | |
| sitetitle | optional, defaults to the existing value The site title value of the installed application. |
Remove any backups connected to this installed application from the database:
| NAME | VALUE |
| delete-backups | optional, defaults to null Set to 'true' to delete any backups connected to the installed application from the Installatron database. The backup archives will be unaffected. |
Remove the installed application from the database:
| NAME | VALUE |
| delete | optional, defaults to null Set to 'true' to delete the installed application from the Installatron database only. The installed application files and tables will be unaffected. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Further details regarding the success or failure. |
| NAME | VALUE |
| cmd | backup |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| id | required The ID of the installed application to be backed up. |
| expiry | optional, defaults to never Possible values include:
|
| background | optional When defined, the request will exit and the task will be transferred to a background process. Use the tasks API to query the status of the background task.Possible values include:
|
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Further details regarding the success or failure. |
| task | Table of task information if executed as a background process. |
Note: It's always recommended to create a backup prior to updating any installed application.
| NAME | VALUE |
| cmd | upgrade |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| id | required The ID of the installed application to be updated. |
| version | optional, default is the latest compatible version The version to be updated to. Use the browser API to get a list of available versions.Note: A value of 'current' can be used to skip updating (if only plugins and themes). |
| revert | optional, default is "no" If set to 'yes', a backup will be created prior to attempting the upgrade, and the backup will automatically be restored if the upgrade fails. |
| plugin | optional If set to '*' or a comma-separated list of plugin ID's, all plugins or the listed plugins will be updated to their current version (WordPress only). Use the view API to get a list of installed plugins. |
| theme | optional If set to '*' or a comma-separated list of theme ID's, all themes or the listed themes will be updated to their current version (WordPress only). Use the view API to get a list of installed themes. |
| background | optional When defined, the request will exit and the task will be transferred to a background process. Use the tasks API to query the status of the background task.Possible values include:
|
| dryrun | optional When defined, the request payload is validated but not executed. Dryrun set to a value of 2 checks everything, and dryrun set to a value of 1 just checks input so it can return faster. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Further details regarding the success or failure. |
| task | Table of task information if executed as a background process. |
| NAME | VALUE |
| cmd | clone |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| id | required The ID of the installed application to be cloned. |
| url | required The URL where the application should be cloned to. |
| url_ip | optional, default is the IP address resolved via DNS If the DNS will not resolve the provided url to the correct IP, use this argument to provide the correct IP. |
| db_host | required if the application requires a database, can be omitted if database automation is implemented The database server. |
| db_name | required if the application requires a database, can be omitted if database automation is implemented The pre-created database. |
| db_user | required if the application requires a database, can be omitted if database automation is implemented The pre-created database username. |
| db_pass | required if the application requires a database, can be omitted if database automation is implemented The pre-created database password. |
| db_prefix | optional If a database prefix other than the default prefix should be used, specify the value here. |
| background | optional When defined, the request will exit immediately and the task will be transferred to a background process after preliminary error checking. Use the tasks API to query the status of the background task. |
| dryrun | optional When defined, the request payload is validated but not executed. Dryrun set to a value of 2 checks everything, and dryrun set to a value of 1 just checks input so it can return faster. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Further details regarding the success or failure. |
| task | Table of task information if executed as a background process. |
| NAME | VALUE |
| cmd | restore |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| id | required The ID of the installed application backup to be restored. |
| db | optional Set to 'manual' to skip creating the database when it doesn't exist. Setting this to 'manual' is recommended if the database is always created prior to calling this API. |
| background | optional When defined, the request will exit immediately and the task will be transferred to a background process after preliminary error checking. Use the tasks API to query the status of the background task. |
| dryrun | optional When defined, the request payload is validated but not executed. Dryrun set to a value of 2 checks everything, and dryrun set to a value of 1 just checks input so it can return faster. |
If the backup should be restored to a location different than the original location:
| NAME | VALUE |
| url | required The URL where the backup should be restored to. |
| url_ip | optional, default is the IP address resolved via DNS If the DNS will not resolve the provided url to the correct IP, use this argument to provide the correct IP. |
| db_host | required if the application requires a database, can be omitted if database automation is implemented The database server. |
| db_name | required if the application requires a database, can be omitted if database automation is implemented The pre-created database. |
| db_user | required if the application requires a database, can be omitted if database automation is implemented The pre-created database username. |
| db_pass | required if the application requires a database, can be omitted if database automation is implemented The pre-created database password. |
| db_prefix | optional If a database prefix other than the default prefix should be used, specify the value here. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Further details regarding the success or failure. |
| task | Table of task information if executed as a background process. |
| NAME | VALUE |
| cmd | delete |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| id | required The ID of the installed application backup to be deleted. |
| force | optional, default is disabled Include this argument to force the deletion even if there are connection errors. |
| background | optional When defined, the request will exit and the task will be transferred to a background process. Use the tasks API to query the status of the background task.Possible values include:
|
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Further details regarding the success or failure. |
| task | Table of task information if executed as a background process. |
| NAME | VALUE |
| cmd | importbackup |
| key | required part of the Request Header that must be included with all API requests |
| user | required The user to import the backup for. |
| path | required The path to the installed application backup archive to be imported, relative to the path defined for the user specified. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Further details regarding the success or failure. |
| NAME | VALUE |
| cmd | uninstall |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| id | required The ID of the installed application to be uninstalled. |
| force | optional, default is disabled Include this argument to force the uninstall even if there are connection errors. |
| background | optional When defined, the request will exit and the task will be transferred to a background process. Use the tasks API to query the status of the background task.Possible values include:
|
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Further details regarding the success or failure. |
| task | Table of task information if executed as a background process. |
| NAME | VALUE |
| cmd | tasks |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | Table of currently executing and recently completed tasks. |
{
"result": true,
"message": "The task is complete.\n",
"data": [
{
"id": "138207901722178300",
"user": "dev1",
"ws_label": "dev1",
"url": "http://dev1.dev-is4.installatron.com/pppoposdopsd3",
"title": "My blog (3)",
"label": "_tasks_backuping",
"status": "processing",
"rate": 10150,
"percentMin": 50,
"percentMax": 99,
"message": "_tasks_shared_copyingfiles",
"cmd": "backup",
"install": "4yhfygnd10ws0wc8skck444s",
"time": 1382079023
}
]
}
The Installatron Server GUI is designed to "piggyback" an existing user or web hosting panel GUI. This model enables Installatron Server to be integrated seamlessly with existing infrastructure.
A session must be created before a user can be redirected to the Installatron Server GUI. This is accomplished by issuing a guixfer request.
| NAME | VALUE |
| cmd | guixfer |
| key | required part of the Request Header that must be included with all API requests |
| websites | required part of the Request Header that must be included with all API requests |
| user | required part of the Request Header that must be included with all API requests |
| reseller | optional part of the Request Header that must be included with all API requests |
| language | optional, default is the systemwide default language or English The language the user interface should display in. For example, "en" for English or "nl" for Dutch. See: Available Installatron Translations. If omitted, the default language or English is assumed. |
optional, default is the per website email value (if defined) or an empty string An email address to display within the GUI. This value can also be defined per website. | |
| package | optional Specify a value that enables sets of users to be assigned different applications. For example, this might be set to "no_mysql" or "wordpress_only". The applications assigned are configured within the Installatron Server Admin GUI. |
| reseller | optional, default is the main administrator Assign ownership to a reseller instead of the main administrator. |
This example written in PHP initializes an Installatron Sever session and then redirects to the Installatron Server GUI:
<?php
$query = array(
/* these values define the request header: */
// Note: "key" is the "key=" from /usr/local/installatron/etc/settings.ini
"key" => "8327b11a311aad5a8092d26d209c9e13",
"websites" => array(
array(
"id" => "website123",
"label" => "website.com",
"path" => "ftp://".urlencode("website123")."@12.24.35.11",
"vhosts" => array(
"http://website.com" => "httpdocs",//@note it's assumed "path" is prefixed.
"http://www.website.com" => "httpdocs",
),
"email" => "user@mail.com"
),
array(
"id" => "website124",
"label" => "company.com",
"path" => "ftp://".urlencode("website124")."@12.24.36.22",
"vhosts" => array(
"http://company.com" => "httpdocs",
"http://www.company.com" => "httpdocs",
"https://company.com" => "httpsdocs",
"https://www.company.com" => "httpsdocs",
),
"email" => "user@mail.com",
// Because we are transferring the user into a GUI, we need some mechanism to
// handle databases. See section 3.17.3 for more information.
"db_mode" => "manual",
"databases" => array(
array(
"type" => "mysql",
"host" => "localhost",
"name" => "db134",
"user" => "db134",
"pass" => "0sdhfldsafh"//Note: Providing a password is optional.
),
array(
"type" => "mysql",
"host" => "localhost",
"name" => "db135",
"user" => "db135"
)
)
)
),
/* these values define the request body: */
"cmd" => "guixfer",
"language" => "en"
);
$ch = curl_init("http://installatron.yourhost.com/index.php");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($query));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$reply = curl_exec($ch);
if ( $reply === false )
{
echo "An error occurred: ".curl_error($ch);
return;
}
else if ( strpos($reply,"Error:") === 0 )
{
echo "An error occurred: ".$reply;
return;
}
$reply = json_decode($reply,true);
if ( $reply["result"] === false )
{
echo "An error occurred: ".$reply["message"];
return;
}
header("Location: http://installatron.yourhost.com/index.php?s=".$reply["session_id"]);
Using a similar guixfer request, sessions for administrator and reseller users can also be created. To create a GUI session for an administrator, define the user member to match the "admin=" value in /usr/local/installatron/etc/settings.ini as shown below (the value is usually "admin"). To create a GUI session for a reseller (or sub-reseller), define the user member to the name of the reseller.
Note: Administrators and resellers can access the Installatron Server directly from the login screen if an account is pre-configured. By default the main administrator account is pre-configured. To pre-configure additional accounts reference 3.17.3. Create/edit user data within the Installatron Server database.
| NAME | VALUE |
| cmd | guixfer |
| key | required part of the Request Header that must be included with all API requests |
| type | reseller |
| user | An alphanumeric value that will represent the reseller. This argument will be used to index data and cannot change. |
| reseller | optional, default is the main administrator Assign ownership to a reseller instead of the main administrator. |
Example:
<?php
$query = array(
/* these values define the request header: */
"key" => "8327b11a311aad5a8092d26d209c9e13",
"user" => "reseller123",
/* these values define the request body: */
"type" => "reseller",
"cmd" => "guixfer",
);
When using the Installatron Server API databases are always created prior to invoking the API. However, this model degrades when applied to the GUI, as it's often desired to limit each database to one installed application. The Installatron Server GUI can solve this problem in two different ways:
The preferred solution is to implement a PHP class that Installatron Server then uses to list, create, and delete databases. Under the default configuration, this solution creates a separate database for each installed application.
A second, more simple solution is keep the API's model of pre-creating databases. Database information can be set per website in the "guixfer" API request. However, a warning: there are some applications (SugarCRM, Tiki Wiki) that don't support table prefixes, so attempting to install these applications will cause database table collisions. We recommend disabling these applications when this solution is used. See the example in section 3.17.1 to reference how to implement this solution.
To use the preferred solution, implement each of the below PHP methods into the /usr/local/installatron/etc/panel.php PHP file. Here's sample code to get started:
<?php
class i_custom extends i_panel
{
/**
* This method enables you to format the database name Installatron Server will expect to be created.
*
* @param string Database type (typically "mysql", can also be "mssql")
* @return array (Database name, database user, database password, database host, database table prefix)
*/
public function generateDB($type)
{
//@note
// itron::$session is a PHP array referencing the selected website. If you define "_some_prefix"
// when calling "guixfer" for the selected website it will be available in this array.
// All custom variable names must begin with an underscore (_).
$prefix = itron::$session["_some_prefix"]."_";
// Maximum database name length, including prefix.
$len_max = 16;
$len_less_prefix = $len_max-strlen($prefix);
//@note
// This must generate a UNIQUE database name that can be passed to createDB to be created.
// PHP's uniqid function uses the system microtime, and this is often good enough
$db_name = $prefix.substr(uniqid(), 0, $len_less_prefix);
$db_host = "localhost";
$db_user = $db_name;//same as the db name
$db_pass = null;//let Installatron create a randomized value.
$db_table_prefix = null;//let Installatron manage table prefixes
return array($db_name, $db_user, $db_pass, $db_host, $db_table_prefix);
}
/**
* Create a database
*
* @param string New database name. This is typically set by generateDB.
* @param string New database username. This is typically set by generateDB.
* @param string New database username's password. This is typically set by generateDB.
* @param string Database type (typically "mysql", can also be "mssql")
* @param string New database's server. This is typically set by generateDB.
* @return bool true if successful; false otherwise
*/
public function createDB($name, $user, $pass, $type, $host)
{
switch($type)
{
case "mysql":
//@todo
// create the database here
return true;
}
return false;
}
/**
* Remove a database.
*
* If database usernames are tied to database names,
* the database username can also be removed.
*
* @param string Name of database to be removed
* @param string Database type
* @return bool true if successful; false otherwise
*/
public function removeDB($name, $type)
{
switch($type)
{
case "mysql":
//@todo
// delete the database here
// this might be a call to your control panel's API,
// or could be something like this:
$db = mysql_connect("localhost", "root", "rootspass");
mysql_query("DROP DATABASE ".mysql_real_escape_string($name, $db), $db);
mysql_close($db);
return true;
}
return false;
}
}
Don't hesitate to contact Installatron Support with any questions.
Most commonly the path variable for each website is directly defined within the Request Header. This optional method allows the path variable to be omitted from the Request Header. This can provide a superior level of security since path authentication information can be activated or created only when needed.
The disablePathByWebsite method is called between 30 minutes and 4 hours after a session's last action.
To use this method, implement each of the below PHP methods into the /usr/local/installatron/etc/panel.php PHP file. Here's sample code to get started:
<?php
class i_custom extends i_panel
{
/**
* Return the path URI for the provided website.
*
* @param array An array of website information as defined in the Installatron Server API Request Header.
* @return string The URI for the website path, as it would have been defined for the Installatron Server Request Header.
*/
public function enablePathByWebsite($websiteInfo)
{
return "ssh://".urlencode("user").":".urlencode("pass")."@11.42.62.82/domains";
}
/**
* Disable the path, if necessary, when Installatron Server no longer requires access.
*
* @param array An array of website information as defined in the Installatron Server API Request Header.
* @return bool true if successful; false otherwise
*/
public function disablePathByWebsite($websiteInfo)
{
return true;
}
}
Contact Installatron Support with any questions.
Installatron Server uses the path defined within the Request Header to communicate with the destination web server. Due to the nature of the protocol, all FTP-based protocols (FTP, FTPS and SFTP) limit the speed at which file operations can be completed.
To improve performance when using a FTP-based protocol, a SSH connection can be activated on demand which enables Installatron Server to execute commands efficiently on the destination web server.
To use this option, implement each of the below PHP methods into the /usr/local/installatron/etc/panel.php PHP file. Here's sample code to get started:
<?php
class i_custom extends i_panel
{
/**
* Return the path URI for the provided website.
*
* @param array An array of website information as defined in the Installatron Server API Request Header.
* @return string The URI for the website path, as it would have been defined for the Installatron Server Request Header.
*/
public function enableSecondaryPathByWebsite($websiteInfo)
{
return "ssh://".urlencode("user").":".urlencode("pass")."@11.42.62.82/domains";
}
/**
* Disable the path, if necessary, when Installatron Server no longer requires access.
* This method is called immediately after the connection is no longer needed by Installatron Server.
*
* @param array An array of website information as defined in the Installatron Server API Request Header.
* @return bool true if successful; false otherwise
*/
public function disableSecondaryPathByWebsite($websiteInfo)
{
return true;
}
}
Contact Installatron Support with any questions.
This optional method enables Installatron Server user and associated website data to be modified (or created if the user doesn't exist).
By default all users are owned by the main administrative user. Creating resellers and/or sub-resellers allows sets of users to be managed separately and assigned different branding, theming, and other settings.
Note: It is not necessary to create users prior to transferring them into the Installatron Server GUI. Please reference 3.16.1. Accessing the GUI as a website owner for more information.
| NAME | VALUE |
| cmd | edituser |
| key | required part of the Request Header that must be included with all API requests |
| user | required The ID of the user to edit or create. |
| type | optional, default is the existing value or "user" for new users The type of user. Valid values are "user" and "reseller". |
| websites | optional, default is the existing value or no websites for new users List of websites for the user. Please reference 3.1. Request Header for arguments. Reseller-type users can have their own websites defined, however typically this argument is omitted for resellers. |
| language | optional, default is the existing value or the systemwide default language or English for new users The language the user interface should display in. For example, "en" for English or "nl" for Dutch. See: Available Installatron Translations. If omitted, the default language or English is assumed. |
optional, default is the existing value or the per website email value (if defined) or an empty string for new users An email address for the user. This value can also be defined per website. | |
| package | optional, default is the existing value or an empty string for new users Specify a value that enables sets of users to be assigned different applications. For example, this might be set to "no_mysql" or "wordpress_only". The applications assigned are configured within the Installatron Server Admin GUI. |
| reseller | optional, default is the existing value or the main administrator for new users Assign ownership to a reseller instead of the main administrator. |
| suspended | optional, default is the existing value or "no" for new users Whether the user is suspended. Valid values are "yes" and "no". |
curl https://installatron.com/server/v1 \ -d "key=8327b11a311aad5a8092d26d209c9e13" \ -d "cmd=edituser" \ -d "user=r12345"
Create a sub-reseller named r12346 which is owned by the reseller r12345.
curl https://installatron.com/server/v1 \ -d "key=8327b11a311aad5a8092d26d209c9e13" \ -d "cmd=edituser" \ -d "reseller=r12345" \ -d "user=r12346"
As a further example, list installations owned by reseller r12345 and all sub-resellers and users:
curl https://installatron.com/server/v1 \ -d "key=8327b11a311aad5a8092d26d209c9e13" \ -d "cmd=installs" \ -d "user=r12346" \ -d "filter-ownedaccounts=yes"
This optional method enables Installatron Server user and associated website data to be deleted, for example after an account is terminated.
| NAME | VALUE |
| cmd | deleteuser |
| key | required part of the Request Header that must be included with all API requests |
| user | required The ID of the user to be deleted. All websites and associated installed app data will be removed from the Installatron Server database. |
| NAME | VALUE |
| result | true on success, or false on failure. |
| message | Success or failure message. |
| data | List of deleted users. |
1.0.4.0.10 (2023-02-08)
1.0.4.0.9 (2022-10-28)
1.0.4.0.8 (2019-10-30)
1.0.4.0.7 (2017-06-30)
1.0.4.0.6 (2016-01-11)
1.0.4.0.5 (2015-10-08)
1.0.4.0.4 (2015-09-23)
1.0.4.0.3 (2015-09-18)
1.0.4.0.2 (2015-06-30)
1.0.4.0.1 (2015-06-25)