A description of the Applications Browser tab user interface and the 3 actions that can be initiated within.
A description of the My Applications tab user interface, the 7 actions that can be initiated within, and the edit pages.
A description of the My Backups tab user interface and the 2 actions that can be initiated within.
A description of the Settings tab user interfaces and pages within.
1. noun: a tool the typically steps through one or more pages, collecting information, before performing a task as the final step. eg. "the uninstall wizard" refers to a tool that uninstalls an application.
Installatron provides an easy to use UI that features the following controls and buttons that are consistent on all Installatron UI pages.
At the top-right of every Installatron screen are several small icons:
return to control panel
Takes you to the main page of your control panel login.
switch to embedded
Switch to "embedded", where Installatron appears inside the control panel theme.
switch to full screen
Switch to "full screen", where Installatron is not surrounded by the control panel theme.
? open the documentation
Open this documentation at installatron.com.
The "tabs" bar (short for "tabbed document interface") gives you access to the main Installatron tools. The complete tabs bar, with all possible tabs, looks like this:
Note that some servers might be configured to replace the Applications Browser tab with a tab for a single application.
Each tab is fully documented in the following chapters.
The "Applications Browser" tab allows you to explore and compare the applications that are available for installing on your website. And when you find an application that you like you can install it by clicking the install button.
Tools to filter the applications list.
Return to the previous page. (Only when on a sub-page.)
Toggle between listing all applications or only those applications that require a database.
Toggle between listing all applications or only those applications available in your native language.
If you're looking for a specific application or kind of application, use search to find it quickly. Type text in the search field at the top right of the Applications Browser page, and then press Return on your keyboard to display the results.
Applications are grouped by category.
Click these category headers to view only the applications in that category and then click "All Applications" to return to the full application list.
Click an application's icon to view that application in detail.
|
In addition to the application's name, icon, and a short description written by Installatron this main part of the application's details the following tools:
Click this button to install a new instance of the selected application. See Tutorials: Install for more information.
≡View more actions. This toggles the full list of actions.
+ install this applicationClick this link to install a new instance of the selected application. This the same as pressing the button with the same name. See Tutorials: Install for more information.
import existing installClick this button to import an existing instance of the selected application type from your webhosting account. See Tutorials: Import for more information.
|
The sidebar, in the application view, presents the following high-level details and resources about the application:
INFORMATION
Meta information about this application and Installatron's installer for this application.
Application
The name of the application.
Category
The type (an Installatron categorization) of application. Click the link to view Applications Browser with this application's category (another Installatron categorization) selected.
Current Versions
The newest version currently supported by Installatron installer. If Installatron's installer supports multiple branches (an Installatron categorization) of this application then the newest version of each branch will be shown.
Last Updated
The date this installer was last updated.
Languages
The languages supported by Installatron's installer for this application.
REQUIREMENTS
Some of the high-level requirements of the newest version of this application.
Note that older versions of the application will likely have different requirements.
Cost
The price of using this application.
Install Size
The disk space requirements for this application.
License
The end user license agreement (EULA) for using this application. Click the link to view the full license.
SUPPORT
Useful support links for this application.
Each application can show any or all of these link:
- The application's website.
- The application's documentation.
- The application's frequently asked questions (FAQ).
- The application's support page (forums, developer contact, etc).
- Installatron's support system.
RELATED APPS
A random selection of similar apps.
click these tabs
|
The final area of the application view is the contents area which is comprised of 4 tabs filled with more details about the application.
Overview
Screenshots of the application's UI and a description of the application taken from the application's website.
What's New
The application's changelog.
Live Demo
Live instances of the application's front end and back end -- for each branch that Installatron manages -- that are typically hosted on installatron.com.
Showcase
Examples of actual websites created using this application.
The install wizard collects information, such as the domain and version, and then installs the application. Each section of the install wizard is detailed below:
The "Location" section prompts you to select a destination for the application, in the form of a "URL". A URL is a website link, comprised of a domain and an optional directory.
Domain
Select the protocol ("http" or "https") and domain for the new application. The drop-down list contains all domains and sub-domains known to be associated with your web hosting control panel login.
Tip: Contact your web hosting provider if the domain you want to use isn't listed.
Directory (Optional)
Enter an optional directory. The directory will be added to the selected domain to determine the destination for the application.
Leave this field empty if you wish to install into the "docroot" (aka. home directory, www root, top-level directory) of the domain.
Allows you to configure the version and content that will be installed.
Version
Select the version you wish to install.
The list includes all versions that are supported by the application package, and versions may be grouped into "branches" (which shows where the application underwent major changes).
Versions that are not compatible with the server that your domain is hosted on will be identified as not-installable, if selected, and a reason why they can't be installed on your webhosting account may be shown.
Tip: You should always install the latest version that you are able to install, unless you particularly need an older release.
Language
Select the language you would like Installatron to install the application in.
The available languages vary from application to application. And you often have more language options to install through the application once it is installed.
Template
only if two or more template options exist for this application
If an application has more than one template options then this field allows you to select which template you want to use for this install:
Content
Empty ContentGive me a clean install (I'll add my own content!) Demo ContentYes, please add the demo content! Example TemplateInstall this example template.Content options can include no extra content, various types of demo content provided by the application itself, Applications: Templates created by your webhosting provider, and Settings: Templates that you yourself have created.
default (when more than one content option exists) varies from application to application and by how your webhosting provider has configured Applications: Access Control
Most web applications have a block of settings that allow you to customize the application. For example, an application might ask you to enter an administrator password or an email address that will be added to the application.
The values set can be modified later within Installatron or within the installed application.
Some common examples include:
Administrator Username
Most applications will ask you for the administrative user's username you would like to use, with the default value varying from application to application.
Administrator Password
If the application asks for a username then the install wizard will likely also ask for an administrator password.
Passwords usually need a minimum amount of complexity, meaning that they need a combination of lowercase (a-z), uppercase (A-Z), numbers (0-9), and so-called "special" character (~!@#$%^&*_+{}[]-=`;':"<>?,./).
The purpose of complexity is to make it impossible to hack. Hacking has become so prevalent on the internet now that simple passwords give your login essentially no security at all.
Administrator Email
Many applications will also ask for an email address to use for the administrative user.
Website Title
The installer might ask to enter a title for the website.
Website Tagline
And even a tagline.
Website Options
Some applications (like WordPress) ask if you would like to include some plugins.
Select to let Installatron automatically manage database, automatic updating, automatic backups, email notifications, and other advanced settings.
Select to manage one or all of these advanced settings yourself.
default is "Automatically create a new database for the installed application"
When "Let me manage these settings" is selected:
Some web applications require a database for data storage.
A database systems allows large amounts of data to be stored and retrieved in a fast and efficient manner, and many applications installed by Installatron require a "database" to store their data. Installatron utilizes a database system called MySQL which is a standard feature of all web hosting services.
Ideally, you will want to use one database for each application that you install. This minimizes the need for technical knowledge (because Installatron can handle the setup and configuration for you) and also minimizes the chance of corruption and accidental data loss.
However, your web hosting service may limit the number of databases: in this case you have the option of sharing a database between multiple installs. This requires some technical knowledge, from you, and not all applications can share a database but it theoretically allows you to install any number of applications using just a single database.
Database Management
🔘 Automatically create a new database for the installed application (Recommended)
Select if you want Installatron to handle database creation and configuration. This requires that your web hosting account has at least one more database available.
🔘 Let me choose an existing database
Select if you wish to control the database usage yourself. You will use this option if you want to make use of database sharing (where one database is used for more than one installation), or if you want to use a specific name for the database. This option is for advanced users.
When "Let me choose an existing database" is selected:
Database Name
Select the database that you want to use for this application. The list contains all databases associated with your webhosting account.
Tip: To add a database to the list, use the "MySQL Wizard", "Database Management" or "MySQL Management" tool from your webhosting control panel.
Database Username
Enter the username for the database-user. This database-user must already exist in your webhosting account and it must have FULL PRIVILEGED access to the database.
Database Password
Enter the password for the database you have selected.
Table Prefix
Enter a table prefix that will be used by tables associated with this install. This should be 1-5 characters in length, and it's always recommended to use a prefix when the option is available.
Tip: An underscore ("_") is not required as Installatron will add it automatically.
Tip: Don't combine shared database usage with applications that don't support custom table-prefix values. Only custom prefixes should be used with database sharing and each application must have a unique prefix.
Select to have Installatron automatically update this application when any new version becomes available.
Select to have Installatron update this application to new minor releases (ie. new versions with a low risk of breaking the website) and security releases (these might be major releases (which can make large changes to the website's database) but since they fix known security problems with the existing version of the application it's still worth going ahead with the auto-update.
Select to not have Installatron automatically update the application. If the appropriate notifications are enabled (see below) then you will receive an email when new versions become available and you can update the application manually from Installatron's UI.
default is "Update to new minor versions and security releases"
(though your webhosting provider can change the default from the Update section of Administration: Features)
Auto-updates execute between midnight and 6AM (server time), and if "Auto-Update Backups" is enabled (see below), where a backup is automatically created prior to the update, the created backup is automatically restored if the update fails. If the appropriate notifications are enabled (see below) then email notifications are sent with the results of each update.
WordPress applications only
Select to have Installatron update plugins as new versions become available.
Select to not have Installatron update plugins. If the appropriate notifications are enabled (see below) then you will receive an email when new versions become available and you can update the plugins manually from Installatron's UI or from the application's administrative backend.
default is "Update all plugins as new versions become available"
(though your webhosting provider can change the default from the Update section of Administration: Features)
WordPress applications only
Select to have Installatron update themes as new versions become available.
Select to not have Installatron update themes. If the appropriate notifications are enabled (see below) then you will receive an email when new versions become available and you can update the themes manually from Installatron's UI or from the application's administrative backend.
default is "Update all themes as new versions become available"
(though your webhosting provider can change the default from the Update section of Administration: Features)
Select to have Installatron automatically create a backup of the application prior to any update of this application. These backups will expire after 14 days though your webhosting provider can change the number of days these backups last from the Update section of Administration: Features. Additionally, if the update fails when this feature is enabled Installatron will automatically restore the backup.
Select to not have Installatron create a backup prior to automatic-updates of this application.
Select the backup location that will be used by this application. The backup location can be changed later.
The "My web hosting account" value refers to the "~/application_backups/" folder in your webhosting account.
If there are other locations listed they can be backup locations added by your webhosting provider or backup location that you have added.
Press the "Install" button to begin installing the files, directories, and database tables. This involves sourcing and extracting archives, calling the app's own install scripts over HTTP, and applying CHMOD values to files and directories. Most install processes take less than a minute or two.
You will be redirected to the "My Applications" tab while the install executes in the background, and because the process is executing in the background you are free to navigate away from Installatron if you wish.
The import wizard will collect options, check that the application exists in this account, and then add the application to the Installatron UI. The import wizard options are detailed below:
Press the button under this title to continue with the import wizard.
The "Location" section prompts you for the location of the existing installed application as the combination of a domain and a folder. This should direct Installatron to the top level folder of the application that you wish to import.
Domain
Select the protocol ("http" or "https") and domain where the application is installed. The drop-down list contains all domains and sub-domains known to be associated with your web hosting control panel login.
Tip: Contact your web hosting provider if the domain you want to use isn't listed.
Folder (Optional)
An optional sub-folder for the source application's location.
Leave this field empty if the application is installed into the "docroot" (aka. home directory, top-level directory) of the domain.
Press the "Import" button to import the application into Installatron.
You will be redirected to the "My Applications" tab where the imported application is now ready to use.
Tip: Installatron will show an error if it can't find an instance of the selected application at the selected URL. Check that the URL is correct and that you selected the correct application type.
The migrate wizard will collect options, check that the application exists at the remote account, transfer the application to this account and make any necessary changes to it, and then finally it will add the application to Installatr's UI. The migrate wizard options are detailed below:
Press the button under this title to continue with the migrate wizard.
The source fields refer to the remote account where the application is currently located. The migrate wizard needs to know the source URL (or its IP address equivalent) and a way to log in and find the application's files.
URL
The URL of the source website. This is the address that you enter into your web browser to view the source website.
URL IP Address (Optional)
If the source website's domain has already been transferred to the destination account, meaning that you can no longer view the source website in your web browser, then you can add this optional value -- an IP address as an alternate way for Installatron to find the source website. The IP address needs to be the domain's old IP: the one it used when it was pointing to the source server. Often this is simply the source server's IP address and it is usually shown someone in the webhosting control panel of the source server.
Protocol
The migrate wizard now asks for a way to log into the source server so that the wizard can grab a copy of the source application's files.
Protocol
Select the method that Installatron will use to connect to the server that has the application. Installatron will use this connection to make a backup of the application and transport it to the destination server.
Tip: if you find that one protocol doesn't work then try another. Not all protocols will work on all servers.
🔘 WordPress
The "WordPress" protocol is a special method, available only to WordPress applications, which requires only the application's administrative username and password values. Installatron will use these two install a temporary plugin on the app which is then used to automatically migrate the website to the destination location. The plugin is automatically removed at the end of a successful migration.
Username
The administrative username of the WordPress application.
Password
The administrative password of the WordPress application.
🔘 SSH
🔘 FTP with TLS/SSL
🔘 FTP
🔘 SFTP
These remote connection systems/protocols all use the same values, described here.
Note that SSH is the ideal protocol to use, though unfortunately not all webhosting services have it enabled for users to make use of. The various FTP options can be hit-and-miss depending on the webhosting service.
Server (IP Address or Hostname)
The address of application's web hosting account.
If you don't know the IP address of the web hosting account try entering the domain in the form domain.com (without www. or http://)
Port
The port used to connect to the server for the selected protocol.
Typical values are: 21 for FTP and FTP with TLS/SSL, 22 for SSH and SFTP, or 443 for WebDAV.
Username
The SSH, FTP, or WebDAV account's login name.
Password
The SSH, FTP, or WebDAV account's login password.
Path
A path to the install's files.
The path value is difficult to describe because it depends on a combination of the Protocol that you have selected and how the source application's server is configured.
If you don't already know the correct path for your source application's server then start by creating a file named "showpath.php" in the source application's main directory and give the file this content:
<?php getcwd(); ?>You can then view that script from:
http://{YOUR_DOMAIN}/{POSSIBLE_SUB_DIRECTORY}/showpath.phpThat will show you the full server path to the location of the source application's files. It might look like one of these examples:
/home/myaccount/domains/mydomain.com/public_html (typical DirectAdmin example) /home/myaccount/public_html (typical cPanel main domain example) /home/myaccount/public_html/myaddondomain.com (typical cPanel addon domain example) /home/myaccount/myaddondomain.com (typical cPanel addon domain example) /var/www/vhosts/mydomain.com/httpdocs (typical Plesk domain example) /var/www/vhosts/sub.mydomain.com/httpdocs (typical Plesk sub-domain example) /home/myaccount/domains/mydomain.com/public_html/subdir (typical example subdirectory) /home/myaccount/public_html/subdir (typical example subdirectory) /home/myaccount/public_html/myaddondomain.com/subdir (typical example subdirectory) /home/myaccount/myaddondomain.com/subdir (typical example subdirectory) /var/www/vhosts/mydomain.com/httpdocs/subdir (typical example subdirectory)
The next step is to identify where your SSH or FTP login logs in -- it needs to be somewhere along that path to be usable.
The value of "Path" is then the the remainder of the path from where the login logs in to the end of the path.
For example, if an SSH login on a DirectAdmin server logs into the "/" (server root) then the Path value for the example above will be the full "/home/myaccount/domains/mydomain.com/public_html" or "/home/myaccount/domains/mydomain.com/public_html/subdir" path.
Or if an FTP/S login on a cPanel server logs into the above example addon domain's home directory then the Path value will be "/myaddondomain.com" or "/myaddondomain.com/subdir".
Or if a WebDAV login (on any server type) logs in directly to the application's directory then the Path value will be just "/".
Select a location for the installed application to be cloned to within your web hosting account.
Domain
Select the protocol ("http" or "https") and domain for the clone. The drop-down list contains all domains and sub-domains known to be associated with your web hosting control panel login.
Tip: Contact your web hosting provider if the domain you want to use isn't listed.
Directory (Optional)
An optional sub-directory for the migrated application, once it is imported into Installatron on your destination webhosting account.
Leave this field empty if you wish to clone into the "docroot" (or home directory, or top-level directory) of the domain.
Database Management
🔘 Automatically create a new database for the installed application (Recommended)
Select if you want Installatron to handle database creation and configuration. This requires that your web hosting account has at least one more database available.
🔘 Let me choose an existing database
Select if you wish to control the database usage yourself. You will use this option if you want to make use of database sharing (where one database is used for more than one installation), or if you want to use a specific name for the database. This option is for advanced users.
When "Let me choose an existing database" is selected:
Database Name
Select the database that you want to use for this application. The list contains all databases associated with your webhosting account.
Tip: To add a database to the list, use the "MySQL Wizard", "Database Management" or "MySQL Management" tool from your webhosting control panel.
Database Username
Enter the username for the database-user. This database-user must already exist in your webhosting account and it must have FULL PRIVILEGED access to the database.
Database Password
Enter the password for the database you have selected.
Table Prefix
Enter a table prefix that will be used by tables associated with this install. This should be 1-5 characters in length, and it's always recommended to use a prefix when the option is available.
Tip: An underscore ("_") is not required as Installatron will add it automatically.
Tip: Don't combine shared database usage with applications that don't support custom table-prefix values. Only custom prefixes should be used with database sharing and each application must have a unique prefix.
The "My Applications" tab lists your installs that Installatron is managing. From here you can access your installs and customize how Installatron should manage them.
Tools to filter and configure the display.
Select between detailed and minimal views.
Note that this documentation is for the detailed view only: the minimal view is intended for users who understand the My Applications tab and are comfortable using a simplified view.
Limit the types of installs that are listed on this page. This pops up a list of checkboxes.
A list of checkboxes that allow you to limit the types of installs that are shown on this page. The numbers to the right of each row show the number of entries found in that group.
View All
Check this to view all entries.
My Accounts
admins & resellers only
Check to include entries created by your personal accounts.
Owned Accounts
admins & resellers only
Check to include entries created by your user's accounts.
Live
Check this to view installs marked as live websites.
Staging
Check this to view installs marked as staging websites.
No Issues
Check this to view installs that have no known issues.
Out of Date
Check this to view installs that are out of date (ie. updates are available).
With Issues
Check this to view installs that have known issues.
A text search of your installs.
Each install features its own little feature-packed GUI:
Each element of this application GUI described below:
A screenshot of the website is shown to the left.
Tip: screenshots will only work if Installatron's data servers have access to your website. If Installatron is blocked from accessing the website you will see the application's default image.
The title of the application is shown at top of information block. Click this link to view this your website in a new browser window.
This title is used only in Installatron -- it's there to help you identify your applications, and the title can be changed by pressing the edit button.
Check to select this application (for use with the buttons at the bottom of the list).
|
Displays Live if this is a live site and Stage if this is tagged as a staging site.
A live site is one that is intended to be viewed by the public while staging sites are typically copies of the live site where editing takes place, away from the public view.
Will be grey if the website has no known issues and red when the website has issues.
If the website has 1 or more recognised errors this will display the number of errors and link to the app's status tab.
If the website has 1 or more recognised warnings this will display the number of warnings and link to the app's status tab.
|
(Only when new updates are available.)
Update this install. This will open the upgrade wizard.
The small number ("17" in this example) shows the number of new versions
available to update to.
If this is a WordPress install the available update(s) can refer to updates of the core, its plugins, or its themes.
See Tutorials: Update for more information.
Edit this install. View all known information about the installed application, optionally edit many of the same values, and check its status and logs
See Tutorials: Edit for more information.
Backup this install. This will open the backup wizard.
Backups can later be restored to either the location where they came from or to a different URL.
See Tutorials: Backup for more information.
Clone this install. This will open the clone wizard.
Clone creates an identical copy of the application at a different URL.
See Tutorials: Clone for more information.
Sync this install. This will open the sync wizard.
Sync updates this install using the files and/or database tables from another application of the same type.
Sync is usually performed on what is referred to as a "live" site (that is, a site that is intended to be seen by the public) while the files and tables are usually pulled from what is referred to as a "staging" site (a copy of the site that is not intended to be seen by the public).
See Tutorials: Sync for more information.
View more actions. This toggles the full list of actions.
The full list of actions you can take on this install. Some of these may also be visible as large icons, depending on the width of your screen.
Edit this install. See the description above.
See Tutorials: Edit for more information.
Backup this install. See the description above.
See Tutorials: Backup for more information.
Clone (or create a Stage of) this install. See the description above.
See Tutorials: Clone for more information.
Sync this install. See the description above.
See Tutorials: Sync for more information.
Create a Template from this install.
Templates are used as optional content options when installing a new instance of the original application.
See Tutorials: Template for more information.
Check for Updates. See the description above (the "Update" button).
See Tutorials: Update for more information.
Detach Installatron from this install.
Installatron can be used to install an application and then to manage that installed application, where management includes auto-updates, auto-backups, and checking for errors. To detach Installatron from the application is to tell Installatron to stop managing the install, effectively removing it from Installatron's UI.
This doesn't touch the install's files or its database, it only tells Installatron to stop tracking the install.
See Tutorials: Detach for more information.
Uninstall this install.
This permanently deletes the install's files, database tables, and database too if there are no tables remaining once this install's tables are removed.
It is highly recommended that, once you no longer want the website, that you use this tool to uninstall the website rather than manually delete the website yourself.
See Tutorials: Uninstall for more information.
Note that the amount of information you will see here will depend on the width of your browser window and the status of your install.
The name of the application used to run this website and the current version of the application used by this website.
This install has auto-updating disabled and new versions of the application are available. Or, auto-updating was attempted but the task failed.
Updating the application is strongly recommend. Click this icon to view the install's Status page.
Auto-updating is enabled. Click this icon to edit the auto-updating settings.
Tip: it's important to keep your website's application up to date. The most common avenue for hacking of websites is out of date applications, plugins, and themes.
Tip: what happens if you manually update your website's application outside of Installatron? Installatron will recognise that the application's version has changed and automatically update the version shown here.
A link directly to the application's files, browsed using the server control panel's file manager tool.
Also shows the disk space used by the install's files. The website's files use space from your webhosting account's disk space quota so make sure you have enough disk space to continue maintaining backups and updates for an application of this size.
Click this icon to see more about the install's files location.
Tip: never manually move the application's files! This will break Installatron's connection with the application and if this is an application that is hard-coded to the location where it is originally installed (eg. WordPress) you will also subtly break the website itself.
Instead, you should use Installatron to clone the application to the new location; confirm that it's working; and then uninstall the original.
Or, alternatively; use Installatron to create a backup of the original application and then uninstall it; then restore the backup with the "to a new location" option and select the desired URL.
Installatron automatically handles all of the required internal editing in both of these scenarios.
A link directly to the application's database -- where supported by your webhosting service and only when the application itself utilises a database -- browsed using a server tool named phpMyAdmin tool.
Also shows the size of the install's database. The database uses space from your webhosting account's disk space quota so make sure you have enough disk space to continue maintaining backups and updates for an application of this size.
Click this icon to see more about the install's database configuration.
The version of PHP used by install.
Click this icon to see more about the install's PHP configuration.
The number of backups of this website that Installatron is currently holding.
Click this link to view the website produced by this install.
The icon at the beginning is a visual representation of whether Installatron is managing this website using a "http" or "https" protocol.
Indicates that Installatron is managing this website using a "http" protocol.
Indicates that Installatron is managing this website using a "https" protocol. This does not say anything about whether the SSL certificate, which is required for "https" to work properly, is installed and working.
Tip: if the domain is configured well then both the http and https URLs will go to the same website (though only the https address will be secure -- and then only if the SSL certificate is properly installed and valid), and in that case it doesn't matter to Installatron's management of the application whether its registered as http or https. It will only make a difference to Installatron when the http and https URLs go to different places, or if one of them shows an error.
Tip: you can change the URL that Installatron uses to access the website by editing the app (press its edit button); open its "Domain" status box; click "Edit URL"; click the URL to see the alternate options.
Click this link to load this install's administrative backend into a new browser tab.
For some applications (eg. WordPress, where the server's administrator has this feature enabled), this link will automatically log you into the install's administrative backend.
For other applications this will take you to the administrative backend login page where you can manually log in.
Click this link to load the software's support forum or portal into a new browser tab. This will be the best place to ask questions about using and configuring the application.
The install edit page allows you to view and edit the following information about your install:
The website and application's status.
See Edit: Status for more.
WordPress installs only
The application's plugins.
See Edit: Plugins for more.
WordPress installs only
The application's themes.
See Edit: Themes for more.
The website's backups.
See Edit: Themes for more.
A log of Installatron's interactions with the application and website.
See Edit: Logs for more.
Technical information and configuration options for this install.
See Edit: Settings for more.
General
Installatron settings for this application.
See Settings: General for more.
Application
The website's internal settings.
See Settings: Application for more.
Auto-Update
Automatic-update configuration.
See Settings: Auto-Update for more.
Auto-Backup
Automatic-backup configuration.
See Settings: Auto-Backup for more.
Auto-PHP
Information about the application's PHP requirements.
See Settings: PHP for more.
Files
The application's files.
See Settings: Files for more.
Database
only applications that use a database
The application's database.
See Settings: Database for more.
All of the application and website's meta information, including an analysis of the site's functional and security status.
Any blocks that require your attention will be moved to the top. If there are no blocks needing your attention then this is the block order:
The type of application used by this website. eg. "WordPress", "Magento", "Drupal".
Press ☰ to view more:
View Application Information
Link to the Applications Browser information for this application.
The current version of the install's application. eg. "1.2.3"
Press ☰ to view more:
(Description)
Tells you if the version is the newest version of the application and whether automatic-updating is enabled.
View What's New
Link to the application's changelog.
Check Updates
Link to the Update Wizard.
Shows the status of automatic-updating for this application.
Press ☰ to view more:
(Description)
A longer description of the current automatic-update status.
Edit Automatic Updates
Link to Edit: Settings: Auto-Update.
The domain used by the website. eg. "www.mydomain.com"
Press ☰ to view more:
(Description)
Described whether the domain appears to be working correctly, from the point of view of Installatron.
View Your Website
Link to your website.
Edit URL
Link to Edit: Settings: General.
The amount of disk space used by the application's files. eg. "1.3 GB"
Press ☰ to view more:
(Description)
Shows the amount of disk space available in your webhosting account.
You should try not to let this value reach zero! That has the potential to break your website in significant ways.
View File Manager
only where supported by the control panel
Link to the control panel's file management tool.
Edit Files Configuration
Link to Edit: Settings: Files.
The amount of disk space used by the application's database. eg. "19 MB"
Press ☰ to view more:
(Description)
Describes whether Installatron is able to access the application's database.
View phpMyAdmin
only where supported by the control panel
Link to the control panel's phpMyAdmin (database editor) tool.
Edit Database Configuration
Link to Edit: Settings: Database.
The PHP version used by this website's domain. eg. "8.2.30"
Press ☰ to view more:
(Description)
Describes whether this version of the application is compatible with this version of PHP.
View PHP Configuration
Link to Edit: Settings: PHP.
Edit PHP Configuration
only where supported by the control panel
Link to the control panel's "MultiPHP" or "Select PHP Version" tool.
This tool can be used to change the domain's PHP version. Then we recommend waiting 1 minute. And then the new version of PHP should be working on your domain.
The version of MySQL or MariaDB that is used by your server. eg. "10.6.0"
Press ☰ to view more:
(Description)
Describes whether this version of the application is compatible with this version of MySQL or MariaDB.
View phpMyAdmin
only where supported by the control panel
Link to the control panel's phpMyAdmin (database editor) tool.
Edit Database Configuration
Link to Edit: Settings: Database.
Shows whether SSL is configured for the domain.
Press ☰ to view more:
(Description)
Describes whether SSL is enabled for this website's domain.
View phpMyAdmin
only where supported by the control panel
Link to the control panel's phpMyAdmin (database editor) tool.
Edit Database Configuration
Link to Edit: Settings: Database.
The date when Installatron installed/cloned this application or when this website was imported into Installatron.
Press ☰ to view more:
(Description)
Shows how long this application has been managed by Installatron.
View phpMyAdmin
only where supported by the control panel
Link to the control panel's phpMyAdmin (database editor) tool.
View Logs
Link to Edit: Logs.
The date when Installatron last updated this application (either automatically or initiated manually through the Installatron UI).
Press ☰ to view more:
(Description)
Shows how long ago Installatron updated this application.
Check Updates
Link to the Update Wizard.
The number of backups this application has in Installatron.
Press ☰ to view more:
View Backups
Link to the Edit: Backups tab.
The date when Installatron last backed up this application (either automatically or initiated manually through the Installatron UI).
Press ☰ to view more:
(Description)
Shows which backup location the last backup was stored at.
View Backups
Link to the Edit: Backups tab.
The date of the next scheduled automatic backup.
Press ☰ to view more:
(Description)
Shows which backup location the next backup will be stored at.
Edit Automatic Backups
Link to the Edit: Settings: Auto-Backup tab.
The number of recent task failures.
Press ☰ to view more:
(Description)
Shows a description of recent task failures.
View Logs
Link to the Edit: Logs tab.
WordPress installs only
The plugins used by this WordPress install, the ability to change some plugins settings, and to install new plugins.
Plugin | Installed | Activated | Auto-Update |
---|---|---|---|
BuddyPress 12.3.4 New Version: 12.3.5Check Updates |
|||
Hello Dolly 1.2.3 |
|||
Limit Login Attempts Reloaded 2.34.56 |
Name and current version of the installed plugin.
New Version:
When a new version of the plugin is available, and the Auto-Update column is unchecked for this plugin, the new version is shown here.
Check Updates
When a new version of the plugin is available this button takes you to the Update Wizard.
An "installed" plugin is one that the WordPress application recognises. If it is uninstalled then it's files are in the application's plugins folder but WordPress does not recognise the plugin.
Installed plugins can be turned on and off. They retain their configuration when deactivated so they can be activated again and continue to use their old configuration.
Check to have Installatron automatically initiate updates when new versions of the plugin become available.
WordPress installs only
The themes used by this WordPress install, the ability to change some theme settings, and to install new themes.
Theme | Installed | Activated | Auto-Update |
---|---|---|---|
Twenty Twenty-Five 2.1 |
|||
Twenty Twenty-Four 1.2 New Version: 1.3Check Updates |
Name and current version of the installed theme.
New Version:
When a new version of the theme is available, and the Auto-Update column is unchecked for this theme, the new version is shown here.
Check Updates
When a new version of the theme is available this button takes you to the Update Wizard.
An "installed" theme is one that the WordPress application recognises. If it is uninstalled then it's files are in the application's theme folder but WordPress does not recognise the theme.
Installed themes can be turned on and off. They retain their configuration when deactivated so they can be activated again and continue to use their old configuration.
Check to have Installatron automatically initiate updates when new versions of the theme become available.
The backups associated with this install.
Date the backup was created (or when it will be created).
Number of days before the backup will expire (and be automatically deleted).
Mouse-over the value to see more information about the expiration settings.
Edit the backup to disable expiration.
Version of the application that was backed up (or that will be backed up).
Amount of disk space the backup is using (or an estimation of how much disk space the backup will use).
Where the backup is stored (or will be stored).
An optional description.
Press to open the tools:
Edit the values of this backup.
Download this backup archive to your home computer.
If you downloaded a backup that no longer exists in Installatron's UI and you would like to add it back to Installatron's UI then you only need to upload the backup file to this folder in your webhosting account's home folder:~/application_backups/Then if you reload the My Backups tab in Installatron you should find that the backup is now listed.
This will only work if the backup was originally created by Installatron and it has not been edited.
Return this backup to either the URL where it originally came from or to a new URL.
This initiates the Restore Wizard.
Delete this backup. This will free up the amount of disk space, at the backup location used by this backup, equal to the size of the backup.
Click these to quickly check all or none of the backups.
Click to delete all selected backups.
Installatron's log entries associated with this install.
Date | Severity | Event | Actor | Message |
---|---|---|---|---|
2025-04-03 2:01am | NOTICE |
Backup | exampleuser | Automatic backup 2025-05-21 04-04-45 is complete to My Account per schedule 1 weekly + 1 monthly. |
2025-04-03 2:01am | NOTICE |
Backup | root | Backup 2025-05-20 05-19-25 is complete to My Account. |
2025-04-03 2:01am | INFO |
Backup | exampleuser | Version 24.68 is now available. |
2025-04-03 2:01am | ERROR |
Change | root | Unable to read source install configuration file. View Error Report |
Date and time the log entry was created.
Identifies new versions of applications, plugins, or themes.
Identifies successful actions and changes to the server\'s configuration.
Identifies actions that produced an error. The error is shown in the last column along with a link to a full error log associated with the error.
Type of action or information that initiated this log entry.
Server username of user whose action created this log entry.
Description of the action.
If this log entry is an error there will be a link to its associated error-report at the end of the error message.
A set of sub-pages that allow you to edit things like email notifications, the install's administrative password, automatic updates and automatic backups, and the lists of files and database tables that are included with this install's backups. And a lot more.
GeneralSettings that determine how Installatron interacts with the install and website.
|
ApplicationSettings specific to this version of this particular application. The fields shown here are only examples: each application is different.
|
Auto-UpdateSettings associated with Installatron's automatic updating feature.
|
Auto-BackupSettings associated with Installatron's automatic backup feature.
|
PHPInformation about this version of this application's PHP requirements.
|
FilesInformation about the install's files, and selection of the files associated with this install.
|
DatabaseInformation about the install's database, and selection of the database tables associated with this install.
|
The update wizard will will update the website's application to a newer version: this typically involves replacing the application's current files with new files and updating the database tables.
For some applications types (eg. WordPress) this can also optionally update plugins and themes.
Tip: It is highly recommended that you keep all your installed applications up to date. Out of date software represents a high security risk for your website and to the server that is hosting the website, making them targets for "hacking" and "exploiting" (both can destroy the content of your website).
Tip: Depending on the application and the magnitude of the upgrade, upgrading may not return the software to the exactly the same state it was in before the upgrade. Plugins might be disabled, templates reset, or settings changed. After an upgrade you should always give your website a thorough examination and see if anything needs to be re-established.
The update wizard options are detailed below:
Current Version
read only value
Displays the version that is currently installed.
This value is always in sync with the installed application.
Destination Version
Select the version that you wish to upgrade to. You should choose the highest version that you are able to select.
You will not be able to select a version that is incompatible with the server that your website is hosted on. The incompatibility will be explained if you attempt to select an incompatible version.
You will not be able to select a version, or any version after it, that cannot be auto-upgraded. Software developers sometimes make changes that are too big for automated upgrading. In these cases a manual upgrade path might be available, or more commonly a "migration" path where you create a fresh install of the latest version and then run some manner of export/import process to move the existing content to the new install. See the application's own documentation for information on performing manual upgrades.
If you perform a manual update Installatron will automatically recognize the change.
What's New?
read only
Shows the changelog entries of versions from the version currently installed to the version selected.
These notes, while substantial in length and technicality sometimes, are always worth checking when performing an update to look for changes that might break your website (and so might require some manual tweaking of the website, after update, to get it working properly again).
WordPress applications only
Select the WordPress plugins you would like to be updated during this update procedure.
What's New
Click to view the plugin's release notes.
WordPress applications only
Select the WordPress themes you would like to be updated during this update procedure.
What's New
Click to view the theme's release notes.
The "Backup" section provides an opportunity to create a backup before going ahead with the upgrade.
If you don't already have a backup it is recommended that you use this option to automatically create a backup. If the upgrade fails it can leave your website corrupted, and a backup would be the only way to restore the application and your website.
Backup
🔘 Yes, create a backup before performing the upgrade
Select to have the wizard create backup before continuing with the upgrade.
🔘 No, do not create a backup before performing the upgrade
Select if wish to continue the upgrade process without performing a backup.
Expiration Date
read only value
If the backup is automatically created, this is the date the backup will be automatically deleted.
Estimated Size
read only value
If the backup is automatically created, this is the estimated size of the backup archive.
The backup wizard will export the install's database to a file, compress the extracted database together with all of the install's files into an archive, and then move that archive to the install's backup location. The backup wizard options are detailed below:
Estimated Size
read only value
The first field is an estimation of the size of the archive that will be created.
Backup Location
Select the backup location that will be used by this application. The backup location can be changed later.
The "My web hosting account" value refers to the "~/application_backups/" folder in your webhosting account.
If there are other locations listed they can be backup locations added by your webhosting provider or backup location that you have added.
Label (Optional)
A short description can be added to the backup to perhaps remind you what this backup was for or why it is significant.
(eg. "Prior to changing main theme")
Press the "Backup" button to backup the install.
The clone/stage wizard will create a copy of the source website and optionally tag the new website as a Stage of the source Live site. The clone/stage wizard options are detailed below:
The source section shows you information about the website that is being cloned.
Location
read only value
Shows the source install's URL and path to its files.
Database Name
read only value
Source install's database name.
Table Prefix
read only value
Table prefix used by the source install.
The "Destination" section prompts you for the location for the clone as the combination of a domain and a folder.
Domain
Select the protocol ("http" or "https") and domain where the clone is to be installed. The drop-down list contains all domains and sub-domains known to be associated with your web hosting control panel login.
Tip: Contact your web hosting provider if the domain you want to use isn't listed.
Folder (Optional)
An optional sub-folder for the clone's location.
Leave this field empty if the clone is to be installed into the "docroot" (aka. home directory, top-level directory) of the domain.
Create a Staging site?
Check to mark this as a staging site of the source website this clone was created from.
Functionally, a live site and a staging site are no different when viewed in a web browser. The only difference is how they are displayed in Installatron.
Tip: A live site is one that is intended to be viewed by the public while staging sites are typically copies of the live site where editing takes place, away from the public view.
Database Management
🔘 Automatically create a new database for the installed application (Recommended)
Select if you want Installatron to handle database creation and configuration. This requires that your web hosting account has at least one more database available.
🔘 Let me choose an existing database
Select if you wish to control the database usage yourself. You will use this option if you want to make use of database sharing (where one database is used for more than one installation), or if you want to use a specific name for the database. This option is for advanced users.
When "Let me choose an existing database" is selected:
Database Name
Select the database that you want to use for this application. The list contains all databases associated with your webhosting account.
Tip: To add a database to the list, use the "MySQL Wizard", "Database Management" or "MySQL Management" tool from your webhosting control panel.
Database Username
Enter the username for the database-user. This database-user must already exist in your webhosting account and it must have FULL PRIVILEGED access to the database.
Database Password
Enter the password for the database you have selected.
Table Prefix
Enter a table prefix that will be used by tables associated with this install. This should be 1-5 characters in length, and it's always recommended to use a prefix when the option is available.
Tip: An underscore ("_") is not required as Installatron will add it automatically.
Tip: Don't combine shared database usage with applications that don't support custom table-prefix values. Only custom prefixes should be used with database sharing and each application must have a unique prefix.
Settings Management
🔘 Automatically clone these settings from the source installed application
Select for the clone to keep the configuration of the original application.
🔘 Let me manage these settings
Select if you wish to customize the configuration of the clone.
When "Let me manage these settings" is selected:
Language (example)
where supported by the application
Select the language used by the new application.
Administrator Username (example)
where supported by the application
The username of the new application's administrative user.
Administrator Password (example)
where supported by the application
The password of the new application's administrative user.
Website Title (example)
where supported by the application
The new application website's title.
Website Tagline (example)
where supported by the application
The new application website's tagline.
Then there are the automated updating options:
Automatic Update
For the new application, have Installatron perform: no automatic updates; automatic updates only to minor and security releases; or automatic updates to all new release.
WordPress Plugin Automatic Update
WordPress only
If the new application is WordPress then select whether you want Installatron to automatically update the application's plugins (recommended because WordPress plugins are a common point of hacking and exploit attack), or not.
WordPress Theme Automatic Update
WordPress only
If the new application is WordPress then select whether you want Installatron to automatically update the application's themes (recommended because WordPress themes are a common point of hacking and exploit attack), or not.
Automatic Update Backup
Provides the option for Installatron to create a backup of the application prior to any future update attempt (recommended because if the update process fails you will want a backup to restore).
And finally there are the email settings:
Email Notification
Choose to receive the server's default email notifications from the application or customize its notifications.
Press the "Clone" button to create the clone.
You will be redirected to the "My Applications" tab while the cloning executes in the background, and because the process is executing in the background you are free to navigate away from Installatron if you wish.
The sync data wizard will ask for a source/stage website -- of the same type of site that is being synced -- as well as the list of files and database tables that will be copied from the source website to the website being synced. The sync data wizard options are detailed below:
The source section asks you to select the website that the wizard will pull the files and database tables from. It also asks which files and tables will be pulled.
Location
Select from this dropdown field the website you would like to pull files and/or database tables from.
The list only includes websites that are the same type that is being synced: for example, if the website that is being synced is a WordPress website then only other WordPress websites will in this list.
If stages have been created from this source website then they are listed first because they are most likely to be the websites you will select as the source. The other websites (live website) are then listed -- these can also be selected as the source of a sync.
The Destination asks you to select the files and database tables of the destination website (ie. install being synced) that will be overwritten by the same files and tables of the selected source website.
Location
read only values
The destination website's URL and path to its files.
Files
A list of the destination install's top-level files (that is, the files in the install's main folder).
- files and folders that are checked will be copied from the source.
- files and folders that are unchecked will be not be copied from the source.
- files and folders in red will be copied from the source and will overwrite an existing file or folder.
Tip: Usually you would leave all of the files and folders checked because if you sync only some files -- without being very careful -- has the potential to break the website.
Database
read only values
The name of the destination website's database name.
Prefix
read only values
The table prefix used by the of the destination website.
Tables
A list of the destination install's database tables.
- tables that are checked will be copied from the source.
- tables that are unchecked will be not be copied from the source.
- tables in red will be copied from the source and will overwrite an existing table.
Tip: Usually you would leave all of the tables checked because if you sync only some tables -- without being very careful -- has the potential to break the website.
Given that the sync process will make changes to the website that is undergoing the sync it is recommended that you create a backup of the website before running the sync. This section allows you to have the sync wizard automatically create a backup prior to running the sync.
Backup
🔘 Yes, create a backup before performing the sync
Select to have the wizard automatically create a backup before syncing the website.
🔘 No, do not create a backup before performing the sync
Select to not have the wizard automatically create the backup.
Expiration Date
read only value
If the backup is automatically created, this is the date the backup will be automatically deleted.
Estimated Size
read only value
If the backup is automatically created, this is the estimated size of the backup archive.
Press the "Sync" button to sync the install.
The template wizard asks you for the type of template you'd like to create and then, based on that choice, there might be additional fields to customize the template with a title and image(s).
A short title for the template.
A longer description of the template. This would describe any customizations that are included with this template.
Availability determines both who has access to the template and the type of template this is.
Select to make this template a new Content option only to the user/account that created this template.
Select to make this available as a Content option for the type of application this template is created from.
only for admin and reseller users
Select to convert this template into a new installer, installed from the Applications Browser tab.
When "Make this template available as a new content option for this application" is selected:
1024x640 PNG or 2048x1280 HiDPI PNG, less than 1MB
An image that represents the template as a Content option when installing this type of application.
The default is a screenshot of the source website.
When "Make this template available as a new application" is selected:
512x512 PNG, less than 300KB
An image to represent the new application in the Applications Browser tab.
The default is gray icon.
Select the Installatron category this new application will belong to. Unless the changes in this template are substantial you should choose the same category as the application this template was created from.
The categories are:
2Select the Installatron application type this new application is. Unless the changes in this template are substantial you should choose the same type as the application this template was created from.
The types are:
1024x640 PNG or 2048x1280 HiDPI PNG, less than 1MB
Four screenshots of the application, from different parts of the application's UI.
A detailed description of the application. This is usually just a copy of the description of the application taken from the application's website. This description can use HTML.
URL to a website for this application.
URL to documentation for this application.
URL to a FAQ for this application.
URL to a support page for this application.
Press the "Template" button to template the install.
The detach wizard will tell Installatron to stop managing the website: it detaches Installatron from the website's application.
On some instances of Installatron it does this by deleting an Installatron data file from a hidden folder in your webhosting account (~/.appdata/current/) while in other instances of Installatron it deletes an entry from a system database. In either case, Installatron will no longer auto-backup and auto-update the application, and it will no longer be shown in Installatron's UI.
Some things this does not do:
It does not touch the website's files or its database. The website is unaffected.
It does not delete the website's Installatron backups. They can be deleted from the My Backups tab if you wish.
It does not prevent you from Importing the website back into Installatron at any point if you wish. (Import is the reverse of Detach, and visa versa.)
read only information
The website being detached from Installatron is summarized.
Press the "Detach" button to detach Installatron from the website.
The uninstall wizard will ask you to confirm that you want to uninstall the website, and will then proceed to delete the application's files and database tables, and then finally remove the website from Installatron.
This process does not touch any backups of this website found in Installatron's My Backups tab.
read only information
The website being uninstalled is summarized.
Press the "Uninstall" button to uninstall the website.
The "My Backups" tab lists the backups you have created from Installatron. From here you can download the backups, delete them, or initiate a restore.
Tools to filter and configure the display.
Limit the types of backups that are listed on this page. This pops up a list of checkboxes.
A list of checkboxes that allow you to limit the types of backups that are shown on this page. The numbers to the right of each row show the number of entries found in that group.
View All
Check this to view all entries.
Permanent
Check this to view backups marked as permanent (they will not be automatically deleted).
Automatic
Check this to view backups marked as automatic (they will be automatically deleted when they are replaced with a new backup by their schedule).
Temporary
Check this to view backups marked as temporary (they were created during an update and will be automatically deleted after a set period of time: 12 days by default).
No Issues
Check this to view backups that have no known issues.
With Issues
Check this to view backups that have known issues.
A text search of your backups.
My website blog
|
||||||
Date | Expiry | Version | Size | Location | Label |
2025-04-03 1:23pm | Never | 6.7.8 | 12 MB | My Account 60% |
≡
|
Tools to manage your website backups.
Backups are grouped under the domain that they were taken from (eg. myexampledomain.com), and then by the website's title at the time of the backup (eg. My example blog).
Under the website's title is a link (eg. myexampledomain.com
Backups are created by the auto-backups system, or from your "My Applications" tab, or during an update.
The backups are then listed:
Date
Date the backup was created.
Expiry
When the backup will expire (ie. be automatically deleted).
Example values include "Today", "8 days", and "Never".
Edit the backup to change its expiration behavior.
Version
The version of the application was backed up.
Size
The file size of this backup archive.
Tip: if the backup's Location is "My Account" then the backup is using this amount of your account's disk space quota.
Location
The title of the backup location where this backup is stored.
A value of "My Account" means the backup is stored in ~/application_backups/.
Any other value refers to a custom backup location owned by either your webhosting provider or yourself.
20%
Your webhosting provider can place various types of limits and quotas on backup locations.
If a quota is active then this bubble with a % value shows how full your quota is. Touch, click, or mouse-over this value to see details about the quota limitations.
Label
When backups are manually created they can be given an optional label to help you identify them or to remind you why the backup was created.
≡Actions to take on this backup. Clicking this pops up a list of actions.
A list of checkboxes that allow you to limit the types of backups that are shown on this page. The numbers to the right of each row show the number of entries found in that group.
EditEdit the backup's information (see the next section for more information).
DownloadDownload this backup to your home computer.
RestoreRestore this backup.
This will restore the backup's files and database to a URL within your webhosting account. You can then access the restored website through that URL, assuming its domain is functional.
×DeleteDelete this backup.
Tip: if the backup's Location is not " My Account", meaning that the backup is stored at a remote location, then delete will only work if Installatron is able to connect to the remote server.
Check to select this backup (for use with the buttons at the bottom of the list).
Click these to quickly check all or none of the backups.
Click to delete all selected backups.
The backup edit page.
Source Application
Information about the application from which this backup was taken from.
This application may still exist or might have been uninstalled.
Title
The name of the source website that was displayed in Installatron.
this is a read-only fieldVersion
The version of the application that was backed up.
this is a read-only fieldLocation
The URL of the source application's website.
And the path to the source application's files.
this is a read-only fieldDatabase Name
The name of the database used by the source application.
this is a read-only fieldTable Prefix
The table prefix used by the source application's database tables.
this is a read-only fieldBackup
Information about the backup.
Label (Optional)
An optional description for this backup which can be useful to remind you why the backup was created or at what state the website was in when the backup was made.
Location
Shows the physical location and filename of this backup file.
this is a read-only fieldIf your webhosting provider enforces limits or quotas on the backup location used by this backup you will see information about the current quota usage and details of the limitations.
Expiry
If the backup was created by auto-backups or as part of an update you will see information about the schedule that created the backup, and then additional field which allows you to:
🔘 Allow expiration as scheduled
Select to have the backup automatically expire (and be deleted) based on its original expiration schedule.
🔘 Stop expiration and retain as a permanent backup
Select to switch this to a backup that will never expire. It will only be deleted if you manually delete it.
Press the "Save All" button to save any changes you've made.
The restore backup wizard will restore the selected backup to either the location where it originally came from (from where it was created), or to a new URL.
Press to restore the backup to where it came from. This means that it will be restored to its original URL, files locations, and if the original database still exists the backup's database will be restored to the original database too.
If the original domain is no longer associated with this account Installatron will give an error.
If the original folder or database no longer exist Installatron will recreate them.
Press to restore the backup to a new location. This means that it will be restored to a new URL (which also means a new files location), and a new database will be created for the restored website.
The new location must use a domain that is associated with your webhosting account.
When "Restore to original location" is pressed:
This page summarizes the files and database tables that already exist in the destination location. This is your last chance to confirm that you want to go ahead with this action.
Path
read only value
The destination location's file path.
Files
read only values
A list of files that already exist in the destination folder.
- • files and folders in black will not be overwritten by files from the backup.
- • files and folders in red will be overwritten by files from the backup.
Database
read only value
The name of the destination website's database name.
Tables
read only values
A list of tables that already exist in the destination table.
- • tables in black will not be overwritten by tables from the backup.
- • tables in red will be overwritten by tables from the backup.
Press the "Restore" button to restore the backup to its original location.
Or, when "Restore to a new location" is pressed:
This page asks for the details of the destination location.
Domain
Select the domain, from the dropdown field, where you wish to restore the backup.
Tip: only domains associated with your webhosting account (as the main domain, addon domains, or subdomains) will be found in this list.
Folder (Optional)
optional
You may also enter a folder, or series of sub-folders, if you don't wish to restore the backup to the domain's "root" folder.
Installatron will create these folder(s) if they don't exist.
(eg. "blog")
(eg. "2025/calendar")Tip: with this type of backup restore, Installatron will not allow you to restore to a location or folder where it recognizes that an application (of either the same or different type) already exists.
Database Management
🔘 Automatically create a new database for the installed application (Recommended)
Select if you want Installatron to handle database creation and configuration. This requires that your web hosting account has at least one more database available.
🔘 Let me choose an existing database
Select if you wish to control the database usage yourself. You will use this option if you want to make use of database sharing (where one database is used for more than one installation), or if you want to use a specific name for the database. This option is for advanced users.
When "Let me choose an existing database" is selected:
Database Name
Select the database that you want to use for this application. The list contains all databases associated with your webhosting account.
Tip: To add a database to the list, use the "MySQL Wizard", "Database Management" or "MySQL Management" tool from your webhosting control panel.
Database Username
Enter the username for the database-user. This database-user must already exist in your webhosting account and it must have FULL PRIVILEGED access to the database.
Database Password
Enter the password for the database you have selected.
Table Prefix
Enter a table prefix that will be used by tables associated with this install. This should be 1-5 characters in length, and it's always recommended to use a prefix when the option is available.
Tip: An underscore ("_") is not required as Installatron will add it automatically.
Tip: Don't combine shared database usage with applications that don't support custom table-prefix values. Only custom prefixes should be used with database sharing and each application must have a unique prefix.
Settings Management
🔘 Automatically clone these settings from the source installed application
Select for the clone to keep the configuration of the original application.
🔘 Let me manage these settings
Select if you wish to customize the configuration of the clone.
When "Let me manage these settings" is selected:
Language (example)
where supported by the application
Select the language used by the new application.
Administrator Username (example)
where supported by the application
The username of the new application's administrative user.
Administrator Password (example)
where supported by the application
The password of the new application's administrative user.
Website Title (example)
where supported by the application
The new application website's title.
Website Tagline (example)
where supported by the application
The new application website's tagline.
Some applications may have custom plugin fields too:
Two-Factor Authentication (example)
An example plugin offered by the WordPress installer.
Limit Login Attempts (example)
An example plugin offered by the WordPress installer.
Then there are the automated updating options:
Automatic Update
For the new application, have Installatron perform: no automatic updates; automatic updates only to minor and security releases; or automatic updates to all new release.
WordPress Plugin Automatic Update
WordPress only
If the new application is WordPress then select whether you want Installatron to automatically update the application's plugins (recommended because WordPress plugins are a common point of hacking and exploit attack), or not.
WordPress Theme Automatic Update
WordPress only
If the new application is WordPress then select whether you want Installatron to automatically update the application's themes (recommended because WordPress themes are a common point of hacking and exploit attack), or not.
Automatic Update Backup
Provides the option for Installatron to create a backup of the application prior to any future update attempt (recommended because if the update process fails you will want a backup to restore).
And finally there are the email settings:
Email Notification
Choose to receive the server's default email notifications from the application or customize its notifications.
Press the "Restore" button to restore the backup the new location.
The delete backup wizard will summarize the backup(s) being deleted and then allow you to delete them.
(Summary)
read only information
The backup(s) being deleted are summarized.
Press the "Delete" button to delete the listed backup(s).
The "Settings" tab contains configuration settings, tools, and Installatron information for server administrators and resellers.
SettingsThe user settings allow you to edit your own Installatron preferences. Tip: you can click the links in the two sidebar images, to the left, to go directly to the documentation for that page. |
Entry page for user-level administration contains settings and preferences the user can override.
Settings and preferences for the current user.
Email Address
Enter the email address that Installatron's email notifications will be sent to.
Multiple email addresses can be entered, comma-separated.
default is the user's control panel email address
Theme
Select the Installatron theme used by this user.
default is "Control Panel"
Language
Select the language that Installatron will be presented in (where possible).
Choose "Automatically Detect" to have Installatron choose a language that matches your webhosting control panel's language setting.
default is "Automatically Detect"
Create and manage your personal backup locations.
Tools to manage your personal backup locations.
Create a new backup location (see below).
★
Select the backup location that will be pre-selected as the default value for this field.
default is "My Account" (the user's webhosting account)
Name/Location
The title or URI of the backup location.
A value of "Local Server" refers to your own webhosting account -- this default backup location cannot be deleted but it can be disabled if no backups are currently using this location.
Size
The amount of disk space used by this backup at the backup location.
Used By
Shows the number of applications that use this backup location as their Default Backup Location, and the number of backups currently stored at that location.
your backup locations only
Edit this backup location (see below).
your backup locations only
Delete this backup location.
Note that you cannot delete a backup location that holds existing backups.
Protocol
Tip: if you find that one protocol doesn't work then try another. Not all protocols will work on all servers.
🔘 FTP with TLS/SSL
🔘 FTP
🔘 SFTP
🔘 WebDAV
These remote connection systems/protocols all use the same values, described here.
Note that SSH is the ideal protocol to use, though unfortunately not all webhosting services have it enabled for users to make use of. The various FTP options can be hit-and-miss depending on the webhosting service.
Server (IP Address or Hostname)
The address of the server where backups will be stored.
If you don't know the IP address of the web hosting account try entering the domain in the form domain.com (without www. or http://)
Port
The port used to connect to the server for the selected protocol.
Typical values are: 21 for FTP and FTP with TLS/SSL, 22 for SFTP, or 443 for WebDAV.
Username
The FTP or WebDAV account's login name.
Password
The FTP or WebDAV account's login password.
Path
The folder to store backups. Default is the top level folder.
The path value is difficult to describe because it depends on a combination of the Protocol that you have selected and how the source application's server is configured.
If you don't already know the correct path for your source application's server then start by creating a file named "showpath.php" in the source application's main directory and give the file this content:
<?php getcwd(); ?>You can then view that script from:
http://{YOUR_DOMAIN}/{POSSIBLE_SUB_DIRECTORY}/showpath.phpThat will show you the full server path to the location of the source application's files. It might look like one of these examples:
/home/myaccount/domains/mydomain.com/public_html (typical DirectAdmin example) /home/myaccount/public_html (typical cPanel main domain example) /home/myaccount/public_html/myaddondomain.com (typical cPanel addon domain example) /home/myaccount/myaddondomain.com (typical cPanel addon domain example) /var/www/vhosts/mydomain.com/httpdocs (typical Plesk domain example) /var/www/vhosts/sub.mydomain.com/httpdocs (typical Plesk sub-domain example) /home/myaccount/domains/mydomain.com/public_html/subdir (typical example subdirectory) /home/myaccount/public_html/subdir (typical example subdirectory) /home/myaccount/public_html/myaddondomain.com/subdir (typical example subdirectory) /home/myaccount/myaddondomain.com/subdir (typical example subdirectory) /var/www/vhosts/mydomain.com/httpdocs/subdir (typical example subdirectory)
The next step is to identify where your SSH or FTP login logs in -- it needs to be somewhere along that path to be usable.
The value of "Path" is then the the remainder of the path from where the login logs in to the end of the path.
For example, if an SSH login on a DirectAdmin server logs into the "/" (server root) then the Path value for the example above will be the full "/home/myaccount/domains/mydomain.com/public_html" or "/home/myaccount/domains/mydomain.com/public_html/subdir" path.
Or if an FTP/S login on a cPanel server logs into the above example addon domain's home directory then the Path value will be "/myaddondomain.com" or "/myaddondomain.com/subdir".
Or if a WebDAV login (on any server type) logs in directly to the application's directory then the Path value will be just "/".
🔘 Dropbox
🔘 Google Drive
You will be prompted to authorize Dropbox or Google Drive access upon saving this form.
🔘 Rackspace Cloud
Rackspace Region
(3-letter)
You can find information about Rackspace Region at https://docs.aws.amazon.com/general/latest/gr/s3.htmlRackspace Container
The name of the container where backups are to be stored.
Rackspace Username
The username utilized to authenticated the Rackspace Container.
Rackspace API Key
The API key utilized to authenticated the Rackspace Container.
Rackspace Container Directory (Optional)
Optional directory under the container which backups are to be stored.
🔘 Amazon S3 (Or any S3-compatible service. eg. OVH Object Storage, Hetzner OBJECT STORAGE)
S3 Endpoint
e.g., "s3.us-west-1.amazonaws.com"
You can find information about S3 endpoints at https://docs.aws.amazon.com/general/latest/gr/s3.htmlS3 Region
e.g., "us-west-1"
You can find information about S3 regions at https://docs.aws.amazon.com/general/latest/gr/s3.htmlS3 Bucket
The name of the bucket where backups are to be stored.
AWS Access Key
The access key utilized to authenticate the S3 Bucket.
AWS Secret Key
The secret key utilized to authenticate the S3 Bucket.
S3 Bucket Directory (Optional)
Optional directory under the bucket which backups are to be stored.
Press the "Save All" button to save any changes you've made.
Create and manage your application templates.
Tools to manage your personal templates.
Takes you to your My Applications tab where you can create new templates.
Example Template Title
The template's title.
example template description
The template's optional description, used to describe what installing this content option will add to the base application.
Initiate an install of the application this template was created for. This template will be available as a new Content option.
Edit the template (see below).
Delete the template.
Icon of the type of application this template was created for. Click the icon to go to that application in Applications Browser.
Minimum Version
The minimum version, of the application, that can be installed in accompaniment with this template.
Size
The amount of disk space used when this template is installed along with the application.
Date
The date this template was create.
ID
Internal ID of this Installatron template.
Title
A short title for this template.
This title appears in the above templates list and during the install process when the user is selecting the Content option.
Description
A longer description for this template.
This description appears in the above templates list and during the install process when the user is selecting the Content option.
Preview Image
An image associated with this template.
This description appears in the above templates list and during the install process when the user is selecting the Content option.
The default image is a screenshot of the website that the template was taken from at the time the template was created.
Press the "Save All" button to save any changes you've made.
Your active tasks from the past 10 minutes. Running tasks are executing in the background.
title | url | task | status | elapsed | |
---|---|---|---|---|---|
My blog | website.com |
|
00:00:12 | ||
My poll/survey | website.com |
|
00:01:09 |
Tools to view and cancel both current and recent tasks.
TITLE
The application's internal title.
URL
The application's URL.
TASK
The type of task.
STATUS
The current status of the task as a progress bar and text description.
If the task is complete the entry will also be tinted green.
Note that the percentages and descriptions are only approximate.
EPAPSED
The time taken so far.
Click to cancel the task.
Check to select this task (for use with the buttons at the bottom of the list).
Click these to quickly check all or none of the tasks.
Click to cancel all selected tasks.
Access Installatron's logs via UI.
"1D" to view the last day's log entries.
"1W" to view the last week's log entries.
"1M" to view the last month's log entries.
to select a range of days to view.
Limit the types of log entries that are listed on this page. This pops up a list of checkboxes.
A list of checkboxes that allow you to limit the types of log entries that are shown on this page.
View All
Check this to view all entries.
INFOCheck this to view log entries that show information.
NOTICECheck this to view log entries that show a notice.
ERRORCheck this to view log entries that show an error.
=_get_searchfield_icon("Search");?>
A text search of your logs.
Date
Date and time the log entry was created.
Severity
NOTICEIdentifies new versions of applications, plugins, or themes.
INFOIdentifies successful actions and changes to the server's configuration.
ERRORIdentifies actions that produced an error. The error is shown in the last column along with a link to a full error log associated with the error.
Event
Type of action or information that initiated this log entry.
App
Small icon for the type of application associated with this log entry.
Click the icon to view the application in Applications Browser.
Title
Title of application that initiated this log entry.
Click the title to edit the install in Installatron.
Click the title to view the website in another browser tab.
This icon will not be shown if the website no longer exists.
Indicates whether Installatron uses the "https" or "http" protocol to make HTTP calls to this website.
Actor
Server username of user whose action created this log entry.
Message
Description of the action.
If this log entry is an error there will be a link to its associated error-report at the end of the error message.
Select the page to view and the number of entries per page.
A collection of high-level information and configuration options for Installatron. This includes Installatron's license information (for Installatron Plugin) or key (for Installatron Server); Installatron's logs; the configuration of Groups and Installatron's features. You can also view current active Installatron tasks.
Tools for managing the applications that Installatron installs. You can customize how applications are installed and place limits on the applications that can be installed.
Tools for managing backup schedules, backup locations, and backup limitations.
Tools for customizing Installatron's user interface. Branding, control panel integration, email, locale, message of the day, and theme.
A collection of tools that aid in the management and use of Installatron.
1. noun: in Installatron, a Backup Location is a definition of a remote login to a file service where backups, created by Installatron, can be stored. Installatron supports a variety of login protocols, including FTP, SSH, AWS S3, Dropbox, and Rackspace.
(see: Backups: Locations)
1. noun: in Installatron, a Catalog is a source of Installatron installer scripts.
(see: Applications: Catalogs)
1. noun: in Installatron, a Group is a collection of users (defined either individually, by hosting package, or by reseller). Groups can be given different Installatron settings.
(see: Administration: Groups)
1. noun: in Installatron, Multi-Server is a system that can be used to automatically share one Installatron configuration across many servers.
(see: Tools: Multi-Server)
1. noun: in Installatron, a Schedule is a definition for daily, weekly, and monthly backups.
(see: Backups: Schedules)
1. noun: in Installatron, a Template is a copy of a modified application that is used as either a) a new content option when installing that type of application, or b) a new type of application.
(see: Applications: Templates)
The entry page for Installatron administration contains information about Installatron and its license, and the ability to run Installatron update/repair.
Installatron Resources
Links to Installatron resources.
Installatron Update/Repair
Click to run Installatron update/repair.
This is automatically run each day by Installatron's crontab entry.
Version
Information about Installatron.
Click to view Installatron's "Changelog" page.
Installatron Version
Shows the Installatron version and build.
Version Available
Shows the newest version of Installatron that is available on the currently selected branch (which is displayed at the right side of this field).
A branch value of "NEVER" means that auto-updating of Installatron's core is disabled.
License
Information about Installatron's license.
Installatron Plugin only
Click to force an update of your Installatron license.
Installatron Plugin only
Click to access your Manage Licenses page on installatron.com.
Installatron Licensee
The name associated with your installatron.com account.
Licensing Method
The method used to license this instance of Installatron.
For an Installatron Plugin server this will show the server's IP address while an Installatron Server will show its Product Key.
License Expiration Date
Installatron Plugin only
The expiration date of this server's Installatron Plugin license.
A list of your custom "Groups", along with your reseller's custom Groups.
Groups, which are analogous to "Packages" in webhosting control panels, are used to customize Installatron configurations for different users or different collections of users.
Note: Where rules conflict (where a user is in multiple groups with conflicting rules) the group that is listed higher on this page takes precedence.
admin▼ | members | tools | |
---|---|---|---|
My Group 1 |
Tools to manage your custom Installatron Groups.
Click to add a group.
admin▼
'admin' in this example is the username of the user who owns these groups.
Each entry in this column, directly under this username, is a group that is owned by this user.
Members
Lists the members assigned to this group. Single users (eg. "user1" and "user2" in this example) are displayed in plain text while webhosting packages (eg "#packageC" in this example) begin with the "#" character -- all users that are assigned to the #package are also part of this group.
Tools
The 'Tools' column are actions for each group.
Click to edit the group's configuration (see the next section for more information).
Check to select this group (for use with the buttons at the bottom of the list).
Click these to quickly check All or None of the groups.
Click to delete all selected groups.
Group Title
A name for this Installatron group (eg "My Group 1" in the example above). This is for easy identification.
Owner
The user who created (or is creating) this group.
this is a read-only fieldMembers
The list of members for this group: one user, reseller, or package per line.
Note: Control panel packages must be prefixed with a hashtag (#). Individual users/resellers require no prefix.
Note: Control panel packages and individual users/resellers must be directly owned by the Owner above.
Note: A wildcard * can be entered to target all users and resellers not targeted by other groups.
Press the "Save All" button to save any changes you've made.
Installatron's lowest-level configuration page, with settings to enable/disable Installatron, configure Installatron's updating, manage CPU usage and caching, and configure system libraries.
Installatron Mode
Enable/disable Installatron.
Note that the admin user will still have full access to Installatron even when it is disabled; it is only resellers and users that will find it inaccessible.
default is "enabled"
Core Update Channel
🔘 Edge
Select to use the very latest Installatron build which will often include new features and fixes that are being tested.
🔘 Release
Select for the primary, well-tested version of Installatron. This has all of the latest well-tested bug fixes and features.
🔘 Stable
Select for the branch of Installatron with the most testing. This version is not updated often, and only features and fixes that have been problem-free on the Release channel for a long time will make it to this branch.
🔘 Never automatically update the core
Select to disable Installatron core updating completely. Note that if other software on the server continues to be updated while Installatron is not updating then you should expect Installatron to stop working correctly at some point.
default is "Release"
Update Interval
When Installatron core updating is enabled this setting selects how often Installatron's update/repair cron is run each day.
default is "Once per day"
Fast Update URL
An Installatron Fast Update Server is a mirror of Installatron's data files that is located on your hosting service, allowing many servers to be quickly updated from a local archive rather than burn through bandwidth accessing Installatron's data servers.
If you have set up a Fast Server, enter its domain here.
default is no value (to use Installatron's data servers)
Tasks Allowed
Enter a value of "auto" to automatically set the maximum number of simultaneous server tasks to be the maximum number of CPU threads minus two.
Otherwise, enter a number representing the maximum number of simultaneous systemwide Installatron tasks.
default is "auto"
Tasks Allowed per User
Enter a number representing the maximum number of tasks per user.
This value is superseded by the systemwide "Tasks Allowed" value.
default is "2"
System Load Maximum
Enter a number presenting the maximum load per CPU.
If system load exceeds this number (per CPU thread) then the number of systemwide tasks are reduced to one, to allow the system to catch its breath.
default is "2"
Maximum cache size
Enter the maximum number of megabytes to be used by the local Installatron packages cache.
default is "2000"
HTTP driver
Select the HTTP driver that Installatron will use for all fetch calls.
default is automatically detected
Archive driver for Tar.gz
Select the tar.gz library that Installatron will use for tar.gz archiving.
default is automatically detected
Archive driver for Zip
Select the zip library that Installatron will use for zip archiving.
default is automatically detected
Perl binary path
Enter a path to the server's perl binary.
default is automatically detected
NetPBM binary path
Enter a path to the server's NetPBM binary.
default is no value
ImageMagick binary path
Enter a path to the server's ImageMagick binary.
default is no value
MySQL Host
Enter the MySQL server's hostname or IP address.
default is automatically detected
MSSQL Host
Windows only
Enter the MSSQL server's hostname or IP address.
default is automatically detected
Press the "Save All" button to save any changes you've made.
Configuration for all of Installatron's user-level interactions and actions.
TODO... could we add some headers to these settings groups?
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
Select to allow the user to see Installatron's log entries for their own installs and actions.
Select to disable the user's log tool.
default is "Enable"
Select to have Installatron generate thumbnail images for user's applications.
Select to use generic application icons instead.
default is "Enable"
Select to allow Installatron to automatically log into application's administrative backends where supported by the application.
Select to require users to always manually log into their application's administrative backends.
default is "Enable"
Select to give the users access to the full range of applications.
Select to limit users to a single application (the application is selected from Applications: Access Control).
default is "Display the Applications Browser tab"
Select to allow users to install, restore, migrate, and clone to the the account's shortcut address (eg. "http://123.123.123.123/~myusername").
Select to remove this option from all actions that require a location.
default is "Enable"
Select to allow users to install, restore, migrate, and clone to both http and https locations.
Select to offer only https locations.
default is "Enable both HTTP and HTTPS options"
Select to allow users to install, restore, migrate, and clone to both "www.mydomain.com" and "mydomain.com" versions of each location.
Select to offer only www.-prefixed versions of each location.
Select to offer only non-prefixed versions of each location.
default is "Enable both non-'www.' and 'www.' options"
Select to allow users to install, restore, migrate, and clone to both "www.mysub.domain.com" and "mysub.domain.com" versions of each subdomain location.
Select to offer only www.-prefixed versions of each subdomain location.
Select to offer only non-prefixed versions of each subdomain location.
default is "Enable both non-'www.' and 'www.' options"
Select to pre-select the www.-prefixed location.
Select to pre-select the non-prefixed location.
default is "Yes, default to the 'www.' option for the first domain"
Install
Enable/disable the installing of new applications.
default is "Enable"
Folder suggestion?
🔘 Enable
Select to have Installatron suggest a default sub-folder for new installs, based on the type of application being installed -- "blog" or "forum" for example, when an application is already installed into the selected domain's root.
🔘 Disable
Select to leave the sub-folder field empty.
default is "Enable"
Database Configuration
🔘 Enable
Select to allow users to select a pre-created database for the given task.
🔘 Disable
Select to remove these database options.
default is "Enable"
Email Notification Configuration
🔘 Enable
Select to allow users to customize which email notifications they receive.
🔘 Disable
Select to remove these options.
default is "Enable"
Email Notification Configuration Default
Check the email notifications that will be checked by default.
If "Email Notification Configuration" is enabled then users can change these settings, but if that setting is disabled then all future installs will receive these notifications.
default is "Enable"
Administrative Username Default
🔘 Suggest a randomized username (Recommended for added security)
Select to have Installatron suggest a random admin username.
🔘 Suggest the application's default username
Select to have Installatron suggest the application's default admin username.
🔘 Do not suggest a value
Select to leave the administrator's username field blank, requiring the user to fill in their own value.
default is "Suggest a randomized username"
Administrative Password Default
🔘 Suggest a randomized password (Recommended for added security)
Select to have Installatron suggest a random admin password.
🔘 Do not suggest a value
Select to leave the administrator's password field blank, requiring the user to fill in their own value.
default is "Suggest a randomized password"
Administrative Password Complexity Policy
🔘 Do not enforce a complex password
Select to not require that administrative passwords meet any complexity requirements.
🔘 Enforce a complex password (Recommended for added security)
Select to require that administrative passwords meet modern complexity requirements. (See also: "Administrative Password Minimum Length")
default is "Enforce a complex password"
Administrative Password Minimum Length
Enter the minimum required length for administrative passwords. (Only in affect when "Administrative Password Complexity Policy" is enabled.)
default is "8"
Administrative Email Default
🔘 Suggest the user's email address
Select to have Installatron suggest the user's email address (taken from their their Settings: General email value, which defaults to the user's control panel email address) when an application asks for an email address.
🔘 Do not suggest a value
Select to leave the email address field blank, requiring the user to fill in their own value.
default is "Suggest the user's email address"
Administrative Entry Point
🔘 Randomize the administrative entry point when supported by the application (Recommended for added security)
Select to obfuscate the application's administrative entry point where supported by the application.
🔘 Use the application's default administrative entry point
Select to retain the application's default entry URL.
default is "Randomize the administrative entry point when supported by the application"
Database Table Prefixes
🔘 Abbreviated (eg., "wp_")
Select to use table prefixes based on an abbreviation of the application's name.
🔘 Random (eg., "i3em_")
Select to use random table prefixes.
default is "Random"
WordPress
Check "Two-Factor Authentication" to give users the option of adding the Two-Factor Authentication plugin during install.
Check "Limit Login Attempts" to give users the option of adding the Limit Login Attempts plugin during install.
Check "Multi-Site" to give users the option of installing WordPress in its multi-site mode.
default is all checked
Import from this account
Enable/disable the importing of applications from the user's account into the Installatron UI.
default is "Enable"
Import from different account
Enable/disable the transferring of applications from a different account or remote server into the user's account and then importing of the application into the Installatron UI.
default is "Enable"
Backup & Restore
Enable/disable the the backing up and restoring of user's applications.
default is "Enable"
Update
Enable/disable the updating of user's applications when new versions come available.
default is "Enabled"
Update Backup Expiry
Number of days that backups created for application-updates will remain. After this number of days a backup will be automatically deleted.
Note that this does not apply to backups created through the automatic-backup system (which are expired through their own rules) nor manually created backups (which do not automatically expire).
default is "12"
Automatic Update
🔘 Enable
Select to allow users to enable automatic updating of user applications using Installatron.
🔘 Disable
Select to not allow Installatron to automatically update applications.
default is "Enable"
Options
Select which application update options are available to users (when "Automatic Update" is enabled).
default is all options checked
Default
Select which option is the default value.
default is "Update to new minor versions and security releases"
WordPress Plugins Automatic Update
🔘 Enable
Select to allow users to enable automatic updating of WordPress plugins through Installatron.
🔘 Disable
Select to not allow Installatron to automatically update WordPress plugins.
default is "Enable"
Default
Select which option is the default value.
default is "Update all plugins as new versions become available"
WordPress Themes Automatic Update
🔘 Enable
Select to allow users to enable automatic updating of WordPress themes through Installatron.
🔘 Disable
Select to not allow Installatron to automatically update WordPress themes.
default is "Enable"
Default
Select which option is the default value.
default is "Update all themes as new versions become available"
Automatic Update Rollback
🔘 Enable
Select to allow users to enable backups be automatically created prior to any update attempt, and to automatically restore that backup if the update fails. (Backups created by this method will automatically expire after the number of days set by the "Update Backup Expiry" setting.)
🔘 Disable
Select to not allow automatic backups prior to update attempts.
default is "Enable"
Options
Check which application update options are available to users (when "Automatic Update Backup" is enabled).
default is all options checked
Default
Select which option is the default value.
default is "Create a temporary backup and automatically restore the backup if the update fails"
Force Update After
Set to "Do not automatically update" to disable the forced updating of user's applications.
Set to "Update to new minor versions and security releases" to automatically update to minor/security released after the number of days set below.
Set to "Update to any new version" to automatically update to any new version after the number of days set below.
default is "Do not automatically update"
Number of days
Enter the number of days to wait before forcing an update (when Forced Update After is enabled).
default is "30"
Backup
🔘 Create a temporary backup and automatically restore the backup if the update fails
Select to create a backup prior to the forced update attempt.
🔘 Do not create a backup
Select to go straight to the update.
default is "Create a temporary backup and automatically restore the backup if the update fails"
Clone
Enable/disable the ability for user's applications to be cloned.
default is "Enable"
Sync
Enable/disable the ability for user's applications to be synced.
default is "Enable"
Template
Enable/disable the ability for templates to be created from user's applications.
default is "Enable"
See Tutorials: Templates for more information.
Edit Settings
Enable/disable the ability for users to edit the settings of their applications in Installatron.
default is "Enable"
WordPress Plugin and Theme Management
Enable/disable the ability for users to manage their WordPress plugins and themes in Installatron.
default is "Enable"
Detach
Enable/disable the ability for users to detach Installatron from their installs.
default is "Enable"
Uninstall
Enable/disable the ability for user's applications to be uninstalled.
default is "Enable"
Status: No Backup
Select whether Installatron should treat user's installs with no backups as a warning.
default is "Enable"
Press the "Save All" button to save any changes you've made.
Shows active tasks from the past 10 minutes. Running tasks are executing in the background.
localhost▼ | task | status | elapsed | cpu# | |
---|---|---|---|---|---|
0123456789012345678 |
|
00:00:22 | 0 | ||
0123456789012345678 |
|
00:00:15 | 0 |
Tools to view and cancel both current and recent tasks.
localhost▼
The internal task ID, the user who initiated the task, and the URL of the application the task is performed on.
Task
The type of task.
Status
The current status of the task as a progress bar and text description.
If the task is complete the entry will also be tinted green.
Note that the percentages and descriptions are only approximate.
Elapsed
The time taken so far.
CPU#
The ID of the CPU performing this task.
Click to cancel the task.
Check to select this task (for use with the buttons at the bottom of the list).
Click these to quickly check all or none of the tasks.
Click to cancel all selected tasks.
Access Installatron's logs via UI.
The same logs can be found in /var/installatron/logs/.
"1D" to view the last day's log entries.
"1W" to view the last week's log entries.
"1M" to view the last month's log entries.
to select a range of days to view.
Limit the types of log entries that are listed on this page. This pops up a list of checkboxes.
A list of checkboxes that allow you to limit the types of log entries that are shown on this page.
View All
Check this to view all entries.
INFOCheck this to view log entries that show information.
NOTICECheck this to view log entries that show a notice.
ERRORCheck this to view log entries that show an error.
=_get_searchfield_icon("Search");?>
A text search of your logs.
Date
Date and time the log entry was created.
Severity
NOTICEIdentifies new versions of applications, plugins, or themes.
INFOIdentifies successful actions and changes to the server's configuration.
ERRORIdentifies actions that produced an error. The error is shown in the last column along with a link to a full error log associated with the error.
Event
Type of action or information that initiated this log entry.
App
Small icon for the type of application associated with this log entry.
Click the icon to view the application in Applications Browser.
Title
Title of application that initiated this log entry.
Click the title to edit the install in Installatron.
Click the title to view the website in another browser tab.
This icon will not be shown if the website no longer exists.
Indicates whether Installatron uses the "https" or "http" protocol to make HTTP calls to this website.
Actor
Server username of user whose action created this log entry.
Message
Description of the action.
If this log entry is an error there will be a link to its associated error-report at the end of the error message.
Select the page to view and the number of entries per page.
This is an alternate way to reach the My Applications tab.
Manage sources of Installatron installers for use on your server.
A catalog can be a collection of many application packages or a URL to a single custom application package.
See the Installatron Installer SDK for more information.
url▼ | statistics | status | |
---|---|---|---|
http://data.installatron.com/catalog.xml | 259 applications 6,196 app versions |
active | |
http://mywebsite.com/mycatalog.xml | 1 application 7 app versions |
active |
Tools to manage the Installatron installer sources.
Add a new catalog (see below).
URL▼
The HTTP addresses to the catalogs.
There is a single default Installatron catalog with a URL of:
http://data.installatron.com/catalog.xmlStatistics
Displays the number of applications and versions managed by the catalogs.
Status
Shows if the catalog is "active" or "disabled".
Check to select this group (for use with the buttons at the bottom of the list).
Click these to quickly check all or none of the groups.
Click to delete all selected catalogs.
Catalog URL
Enter the URL to a new Installatron installer catalog. This is expected to be a .xml file in the format described by the Installatron Installer SDK.
Press the "Save All" button to save any changes you've made.
★ | ⊘ | ⊕ | Apps for Community Building▼ |
version | updated | size | php | mysql / mariadb | |
---|---|---|---|---|---|---|---|---|---|
4.1.18 | 4 months | 80mb | 7.48.08.18.2 | 5.65.78.0 1 | |||||
23.03 | 2 months | 10mb | 7.48.08.18.2 | 5.65.78.0 1 | |||||
2021.012 | 1 year | 110mb | 7.48.08.18.2 | 10.310.510.61 | |||||
3.3 | 3 years | 80mb | 7.48.08.18.2 | 10.310.510.61 | |||||
2.1.13 | 7 years | 14mb | 7.48.08.18.2 | 10.310.510.61 | |||||
★ | ⊘ | ⊕ | Apps for content management▼ |
version | updated | size | php | mysql / mariadb | |
4.2.1 | 7 months | 3mb | 7.48.08.18.2 | n/a |
Precise management of the applications (and their branches), including which applications to highlight on the control panel dashboard and a message to display to the user when a particular application they're interested in is disabled.
Check to make this application (or branch of the application) available to users of the selected group.
Unselect to hide this application/branch.default is checked
★
Select this as a featured application. Featured applications are shown on the user's webhosting control panel dashboard (when enabled) and are listed first in the Applications Browser.
⊘
When checked, it disables this application/branch. This application/branch will still be displayed but cannot be installed.
⊕
When checked, only the most recent version of this application/branch can be installed. Import, migration, and other Installatron tasks are not affected by this limitation.
APPS FOR COMMUNITY BUILDING▼
Applications are grouped by Installatron-category under these headers (there are multiple headers down the page).
Each entry shows the application's icon, title, and type.
VERSION
Shows the newest version of this application or the latest version in this branch of the application.
means this application can be auto-updated, by Installatron, to the latest major version.
means this application can be auto-updated, by Installatron, to the latest minor version of its current branch.
UPDATED
How recent was the last update of this installer.
Applications that have not been updated for more than 2 years are shown in red.
SIZE
Shows the combined disk space and database size of the latest version of this application/branch.
PHP
Shows the major PHP versions supported by the latest version this application/branch. Note that some sub-versions of PHP, within each major version, may not be supported.
GREEN versions are supported, GREY versions are not supported.
A value of "n/a" means that the application does not use PHP.
MYSQL/MARIADB
Shows the major MySQL or MariaDB versions supported by the latest version this application/branch. Note that some sub-versions of MySQL or MariaDB, within each major version, may not be supported.
Click the "MYSQL/MARIADB" column header to toggle between showing the MYSQL versions and MARIADB versions.
GREEN versions are supported, GREY versions are not supported.
A value of "n/a" means that the application does not use a database.
Note: An entry marked with 1 do not support database table prefixes and are therefore limited to one install per database.
(future additions to this category)
The last entry in each category defines how new applications and new branches will be automatically configured when added to this category.
Enter the message that users will see when they try to install an installer or branch that is disabled.
default is:
This application requires an account upgrade. Please <a href='http://yourcompay.com' target='_blank'>click here</a> to upgrade your account.
Press the "Cancel" button to cancel any changes you've made.
Provides a way to inject custom code into Installatron's official installers.
See the Installer Customization Guide for more information.
Enter the custom code into this text area.
This is expected to be in the format described by the Installer Customization Guide.
Press the "Save All" button to save any changes you've made.
Allows you to inject custom HTML/PHP code into the footer of each application as it is installed by Installatron.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
Check to enable this feature.
default is unchecked
Enter the code that will be inserted into the footer of each application as it is installed (where supported).
default is:
<a href='https://installatron.com/{id}' target='_blank' title='Get {app} for your website. Installatron enables webmasters to instantly install and effortlessly manage top web applications.'><?php switch (mt_rand(0,2)) { case 0:echo "Automated by Installatron";break; case 1:echo "Powered by Installatron";break; case 2:echo "Installed by Installatron";break; } ?></a>
Press the "Save All" button to save any changes you've made.
Allows you change the Live Demo URL.
See Tools: Live Demo Server for information about building a local instance of Live Demo.
Check to enable this feature.
default is checked
The the URL to the live demo service.
Note that Installatron will automatically mask this URL so that it appears to be hosted on your server.
default is "https://livedemo.installatron.com"
Press the "Save All" button to save any changes you've made.
Allows you to administrate the templates that exist on your server.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
| | WordPress | Size | Created | Minimum Version | Availability | |
---|---|---|---|---|---|---|---|
55 MB | 2025-03-21 | None | Install Content | ||||
88.8 MB | 2025-03-21 | 6.7.2 | Install Content | ||||
111.1 MB | 2025-03-21 | 6.7.2 | Applications Browser |
Tools to manage your server's templates.
Takes you to your My Applications tab where you can create new templates.
Check the templates that will be available for users to install.
Unchecked templates are not available.If only one template is checked the application will not have a "Content" option during the install process -- that single template will be installed.
default is all templates checked
★
Choose which will be the default content option when installing this application.
default is case-by-case
B2EVOLUTION▼
Description of each template.
MINIMUM VERSION
Minimum version, of the application, that the template will work on.
There is no minimum version for templates that are built into the installers.
Custom templates have a minimum version matching the version of the application they were created from.
AVAILABILITY
"Install Content" means that this template appears as a new content option when installing this application.
"Applications Browser" means that this template appears as a whole new application in the Applications Browser tab.
custom templates only
Click to edit the template (see below).
custom templates only
Click to delete the template.
Press the "Save All" button to save any changes you've made.
ID
Internal ID of this Installatron template.
Title
Enter a short name for this template.
This title appears in the above templates list and during the install process when the user is selecting the Content option.
Description
Enter a longer description for this template.
This description appears during the install process when the user is selecting the Content option.
Availability
🔘 Make this template available to the website owner
Select to make this template a new Content option only to the user/account that created this template.
🔘 Make this template available as a new content option for this application
Select to make this available as a Content option for the type of application this template is created from.
🔘 Make this template available as a new application
only for admin and reseller users
Select to convert this template into a new installer, installed from the Applications Browser tab.
default is "Make this template available as a new content option for this application"
When "Make this template available to everyone" is selected:
Preview Image
Attach an image representing this theme.
The image should be 1024x640 PNG or 2048x1280 HiDPI PNG, less than 1MB.
This image appears during the install process when the user is selecting the Content option.
When "Make this template available to everyone as a new application" is selected:
Icon
An icon representing this template as a new application in the Applications Browser tab.
512x512 PNG, less than 300KB
Category
The Installatron application category this template-as-application will be added to.
default is "Content Management"
Type
The Installatron application type this template-as-application is best described as.
default is "blog"
Screenshot #1-#4
Screenshots of the template-as-application. Up to 4 screenshots can be added.
These appear on the Overview tab when the application is viewed in the Applications Browser tab.
Long Description
Enter a long description of the template-as-application, including a description of it's features, benefits, and history.
This long description appears at the bottom of the application's information when viewed in the Applications Browser tab.
App URL
Enter an optional link to a webpage with more information about this template-as-application.
Docs URL
Enter an optional link to documentation for this template-as-application.
FAQ URL
Enter an optional link to a FAQ for this template-as-application.
Support URL
Enter an optional link to a support page for this template-as-application.
Press the "Save All" button to save any changes you've made.
Configure application quotas for users of the selected group, which place limits on the number of applications a user can have on each account and/or domain.
Note: A quota affecting a specific application overrides a quota affecting multiple applications.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
The error that is displayed to users when installing another application will breach an enabled quota.
default is "This application requires an account upgrade. Please <a href='http://yourcompay.com' target='_blank'>click here</a> to upgrade your account."
Quotas
|
| Quota | Action | Applications | |
---|---|---|---|---|
5 per account | Error | b2evolution |
||
5 per domain | Error | All Applications |
Tools to manage your quotas.
Click to create a quota (see below).
Checked quotas are in effect.
Unchecked quotas are not in effect.Action
Shows what happens when an install attempt will breach one of the enabled quotas.
Typically says "Error", meaning that it will show the contents of the "Error Message" field (see above).
Applications
Shows the applications impacted by the quota.
Click to edit the quota (see below).
Click to delete the quota.
Press the "Save All" button to save any changes you've made.
Add Application Quota
Edit Application QuotaApplications
Select the the application(s) that will be affected by this quota. Hold CTRL to select more than one application.
Select the "All Applications" option to have the quota apply to all applications.
Quota
Enter a number that will be the the limit for this quota group, and select whether the quota applies "per account" or "per domain".
Press the "Save All" button to save any changes you've made.
Allows you to configure default backup schedules, limit custom backup schedules, and schedule enforced backups.
A backup schedule is a set number of daily, weekly, and monthly automatic backups that Installatron should keep for an application.
Example: a schedule of 4 daily, 0 weekly, 0 monthly will have Installatron make daily backups of the application and retain the 4 most recent backups. Older backups will be automatically deleted.
Example: a schedule of 0 daily, 0 weekly, 1 monthly will have Installatron make a automatic backup each month, keep the new backup and delete the old backup.
Example: a schedule of 2 daily, 3 weekly, 1 monthly will have Installatron make daily automatic backups and keep just the 2 most recent, plus a weekly backup and keep the 3 most recent, plus a monthly backup and keep just that most recent monthly backup -- all told this schedule will be retaining 6 backups of the applications that use this backup schedule.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
| Schedule | Backup Location | |
---|---|---|---|
Default | |||
Default |
Tools to manage your pre-configured backup schedules.
These schedules will be available to users when they enable automatic-backups on their applications.
Create a backup schedule (see below).
Checked backup schedules are available.
Unchecked backup schedules are not available.Schedule
Shows the backup schedule's daily, weekly and monthly configuration. Mouse-over the schedule for a description of the schedule.
Backup Location
Always says "Default", referring to the install's Default Backup Location.
custom backup schedules only
Click to edit the backup schedule (see below).
custom backup schedules only
Click to delete the backup schedule.
A few methods to place limits on user's custom backup schedules.
Allow website owners to use their own custom backup schedules
Check to allow users to create their own custom backup schedules.
Uncheck to force users to select from only your pre-configured backup schedules.default is checked
Maximum Values
If users are allowed to make custom backup schedules then these are the maximum values they can use for each of the daily, weekly, and monthly fields.
default is 7 daily, 0 weekly, and 0 monthly
Exempt website owner backup locations
If users are allowed to make custom backup schedules but they are using their own backup locations then check this to exempt those backup locations from these "Maximum Values" restrictions. Only schedules made to your backup locations will enforce these maximums.
default is unchecked
| Schedule | Backup Location | |
---|---|---|---|
Default |
Tools to manage your forced backup schedules.
Any enabled forced backed schedules will always be in effect, ensuring that user's applications cannot retain fewer than the number of backups set in these schedules.
Create a forced backup schedule (see below).
Checked forced backup schedules are in effect.
Unchecked forced backup schedules are not in effect.Schedule
Shows the forced backup schedule's daily, weekly and monthly configuration. Mouse-over the schedule for a description of the schedule.
Backup Location
A value of "Default" means the backups will be stored in the Default Backup Location of the application being backed up. A value of "My Account" means the backups will be stored in the user's webhosting account. Other values identify an administrator-owned backup location (see Backups: locations) the backups will go to.
custom backup schedules only
Click to edit the backup schedule (see below).
custom backup schedules only
Click to delete the backup schedule.
Press the "Save All" button to save any changes you've made.
Add Backup Schedule
Edit Backup ScheduleBackup Schedule
Enter the number of daily, weekly, and monthly backups this backup schedule will maintain.
A backup schedule is a set number of daily, weekly, and monthly automatic backups that Installatron should keep for an application.
Example: a schedule of 4 daily, 0 weekly, 0 monthly will have Installatron make daily backups of the application and retain the 4 most recent backups. Older backups will be automatically deleted.
Example: a schedule of 0 daily, 0 weekly, 1 monthly will have Installatron make a automatic backup each month, keep the new backup and delete the old backup.
Example: a schedule of 2 daily, 3 weekly, 1 monthly will have Installatron make daily automatic backups and keep just the 2 most recent, plus a weekly backup and keep the 3 most recent, plus a monthly backup and keep just that most recent monthly backup -- all told this schedule will be retaining 6 backups of the applications that use this backup schedule.
Press the "Save All" button to save any changes you've made.
Add Forced Schedule
Edit Forced ScheduleDisplay Name
The bold text title that appears above the schedule in the Forced Schedules list (see above).
Backup Schedule
Enter the number of daily, weekly, and monthly backups this backup schedule will maintain.
A backup schedule is a set number of daily, weekly, and monthly automatic backups that Installatron should keep for an application.
Example: a schedule of 4 daily, 0 weekly, 0 monthly will have Installatron make daily backups of the application and retain the 4 most recent backups. Older backups will be automatically deleted.
Example: a schedule of 0 daily, 0 weekly, 1 monthly will have Installatron make a automatic backup each month, keep the new backup and delete the old backup.
Example: a schedule of 2 daily, 3 weekly, 1 monthly will have Installatron make daily automatic backups and keep just the 2 most recent, plus a weekly backup and keep the 3 most recent, plus a monthly backup and keep just that most recent monthly backup -- all told this schedule will be retaining 6 backups of the applications that use this backup schedule.
Backup Location
Forced backups can be stored at the install's default backup location or at a backup location of your choosing.
Backups Retainable?
Check to allow users to turn off auto-expiration of backups that were created by the Forced Schedule system.
Press the "Save All" button to save any changes you've made.
Allows you to configure backup locations and place restrictions on user-created backup locations.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
Tools to manage your pre-configured backup locations.
These locations will be available to users when they backup their applications.
Create a new backup location (see below).
★
Select the backup location that will be pre-selected as the default value for this field.
default is "My Account" (the user's webhosting account)
Name/Location
The title or URI of the backup location.
A value of "Local Server" refers to the user's own webhosting account -- this default backup location cannot be deleted but it can be disabled if no backups are currently using this location.
Size
The amount of disk space used by this backup at the backup location.
Used By
Shows the number of applications that use this backup location as their Default Backup Location, and the number of backups currently stored at that location.
your backup locations only
Edit this backup location (see below).
your backup locations only
Delete this backup location.
Note that you cannot delete a backup location that holds existing backups.
Allow website owners to add their own backup locations
Check to allow users to used their own personal backup locations.
Uncheck to force users to use your backup locations.default is checked
Allowed Protocols
Check the protocols that your users are allowed to use for their own backup locations.
The supported protocols are "FTP", FTP with TLS/SSL", "SFTP", "WebDAV", "Dropbox", "Google Drive", "Rackspace Cloud", "Amazon S3".
default is all protocols checked
Press the "Save All" button to save any changes you've made.
Display Name
The name that will be shown to users when representing this backup location. Also appears in the Backup Locations list.
Protocol
Tip: if you find that one protocol doesn't work then try another. Not all protocols will work on all servers.
🔘 FTP with TLS/SSL
🔘 FTP
🔘 SFTP
🔘 WebDAV
These remote connection systems/protocols all use the same values, described here.
Note that SSH is the ideal protocol to use, though unfortunately not all webhosting services have it enabled for users to make use of. The various FTP options can be hit-and-miss depending on the webhosting service.
Server (IP Address or Hostname)
The address of the server where backups will be stored.
If you don't know the IP address of the web hosting account try entering the domain in the form domain.com (without www. or http://)
Port
The port used to connect to the server for the selected protocol.
Typical values are: 21 for FTP and FTP with TLS/SSL, 22 for SFTP, or 443 for WebDAV.
Username
The FTP or WebDAV account's login name.
Password
The FTP or WebDAV account's login password.
Path
The folder to store backups. Default is the top level folder.
The path value is difficult to describe because it depends on a combination of the Protocol that you have selected and how the source application's server is configured.
If you don't already know the correct path for your source application's server then start by creating a file named "showpath.php" in the source application's main directory and give the file this content:
<?php getcwd(); ?>You can then view that script from:
http://{YOUR_DOMAIN}/{POSSIBLE_SUB_DIRECTORY}/showpath.phpThat will show you the full server path to the location of the source application's files. It might look like one of these examples:
/home/myaccount/domains/mydomain.com/public_html (typical DirectAdmin example) /home/myaccount/public_html (typical cPanel main domain example) /home/myaccount/public_html/myaddondomain.com (typical cPanel addon domain example) /home/myaccount/myaddondomain.com (typical cPanel addon domain example) /var/www/vhosts/mydomain.com/httpdocs (typical Plesk domain example) /var/www/vhosts/sub.mydomain.com/httpdocs (typical Plesk sub-domain example) /home/myaccount/domains/mydomain.com/public_html/subdir (typical example subdirectory) /home/myaccount/public_html/subdir (typical example subdirectory) /home/myaccount/public_html/myaddondomain.com/subdir (typical example subdirectory) /home/myaccount/myaddondomain.com/subdir (typical example subdirectory) /var/www/vhosts/mydomain.com/httpdocs/subdir (typical example subdirectory)
The next step is to identify where your SSH or FTP login logs in -- it needs to be somewhere along that path to be usable.
The value of "Path" is then the the remainder of the path from where the login logs in to the end of the path.
For example, if an SSH login on a DirectAdmin server logs into the "/" (server root) then the Path value for the example above will be the full "/home/myaccount/domains/mydomain.com/public_html" or "/home/myaccount/domains/mydomain.com/public_html/subdir" path.
Or if an FTP/S login on a cPanel server logs into the above example addon domain's home directory then the Path value will be "/myaddondomain.com" or "/myaddondomain.com/subdir".
Or if a WebDAV login (on any server type) logs in directly to the application's directory then the Path value will be just "/".
🔘 Dropbox
🔘 Google Drive
You will be prompted to authorize Dropbox or Google Drive access upon saving this form.
🔘 Rackspace Cloud
Rackspace Region
(3-letter)
You can find information about Rackspace Region at https://docs.aws.amazon.com/general/latest/gr/s3.htmlRackspace Container
The name of the container where backups are to be stored.
Rackspace Username
The username utilized to authenticated the Rackspace Container.
Rackspace API Key
The API key utilized to authenticated the Rackspace Container.
Rackspace Container Directory (Optional)
Optional directory under the container which backups are to be stored.
🔘 Amazon S3 (Or any S3-compatible service. eg. OVH Object Storage, Hetzner OBJECT STORAGE)
S3 Endpoint
e.g., "s3.us-west-1.amazonaws.com"
You can find information about S3 endpoints at https://docs.aws.amazon.com/general/latest/gr/s3.htmlS3 Region
e.g., "us-west-1"
You can find information about S3 regions at https://docs.aws.amazon.com/general/latest/gr/s3.htmlS3 Bucket
The name of the bucket where backups are to be stored.
AWS Access Key
The access key utilized to authenticate the S3 Bucket.
AWS Secret Key
The secret key utilized to authenticate the S3 Bucket.
S3 Bucket Directory (Optional)
Optional directory under the bucket which backups are to be stored.
Press the "Save All" button to save any changes you've made.
Allows you to configure backup locations and place restrictions on user-created backup locations.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Enter the error message that will be shown to users when they attempt to create a backup that would breach one or more of the enabled Backup Quotas.
| Quota | Channel | Action | Location | |
---|---|---|---|---|---|
Permanent Backups | Error | All Preconfigured Locations |
Tools to manage your backup quotas.
Backup quotas place limits on the number of backups that can exist at a given backup location based on various rules.
Create a backup quota (see below).
Checked backup schedules are in effect.
Unchecked backup schedules are not in effect.Quota
A summary of the backup quota's rules.
Channel
Shows which type of backups are affected by this quota.
Action
What happens when a new backup will breach these backup quota restrictions.
"Error" will display the "Error Message" (see above).
"Prune" will complete the backup and, if successful, will prune the oldest backup from that location.
Location
The backup location that is affected by these backup quota restrictions.
Click to edit the backup quota (see below).
Click to delete the backup quota.
Press the "Save All" button to save any changes you've made.
Add Backup Quota
Edit Backup QuotaBackup Channels
Choose which types of backups are affected by this backup quota.
The options are:
- Permanent Backups
Manually-instantiated backups, or backups that have no expiration date. These are the default backups handled by quotas.- Expiring Backups
Backups that have been automatically created prior to an application update. These backups will automatically expire after a certain number of days (which is configured in Installatron administration » Features » Update Backups Expiry).- Automatic Backups
Backups created by Schedules. These are also managed, here by the schedule they were created by (see Backups: Schedules -- they can be configured when installing the application and adjusted afterwards). We recommend leaving this channel out of quotas.Location
Select the backup location(s) that are affected by this backup quota.
The first two options are "All Backup Locations" and "All Backup Locations (website owner added locations excluded)".
The third location is "Local Server", referring to backups saved to the user's account.
The remaining options, if they exist, are the custom backup locations from Backups: Locations.
Quota
Configure the quota with these three fields: a number, a choice between "backups" and "megabytes", and a choice between "per installed application", "per domain", and "per account".
For example, a quota could be 5 - backups - per account, or 15 - megabytes - per installed application.
Action
Choose what will happen when a new backup would breach this quota:
" Error" will display the "Error Message" (see above).
" Prune" will complete the backup and, if successful, will prune the oldest backup from that location.
Press the "Save All" button to save any changes you've made.
Configuration options for how Installatron is presented to your users, including renaming Installatron, changing its logo, and modifying external links.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
You can change Installatron's name with this field.
Only user-level accounts will see the name change -- administrators will continue to see the name "Installatron".
default is "Installatron"
You can also change the "subtitle" that appears on the link to Installatron from the control panel UI.
default is "Applications Installer"
You can also change the logo that appears at the top-left of all Installatron pages.
default is "https://installatron.com/images/installatron_logo.png"
Alphanumeric string that appears in the URL when accessing Installatron pages.
default is "installatron"
Change this URL if you want users to use your support service for all Installatron-related support.
Uncheck this checkbox to disable Installatron support links.
default is "https://installatron.com/tickets"
Enter an alternate URL for Installatron's user-level documentation.
Uncheck this checkbox to disable user documentation links.
default is "https://installatron.com/docs/user"
Enter an alternate URL for Installatron's admin-level documentation.
Uncheck this checkbox to disable admin/reseller documentation links.
default is "https://installatron.com/docs/admin"
Edit the name of the webhosting control panel software.
default is automatically detected
Provide the name of your webhosting service.
default is "Service Provider"
Provide a URL to your support service.
default is no value
Press the "Save All" button to save any changes you've made.
Customize Installatron's integration into the webhosting control panel, including changing of the Installatron name and logo, and the inclusion of application lists in the control panel dashboard (where supported).
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
Installatron's name as shown on the control panel's dashboard.
A URL to Installatron's "button" image, displayed on the control panel's dashboard. This image should be 48x48 pixels and can be any format supported by web browsers.
defaults are "Installatron" and "https://installatron.com/images/installatron_button.svg"
For control panel themes that support it, you can add individual apps to the "software" block of the control panel by adding lines to this field.
To add single-application links enter the application's ID, then a space, then the text that will be shown in the software block for this application.
eg. "wordpress WordPress CMS"
default is no entries
For control panel themes that support it, checking this field will add an Installatron link to the control panel's "tabs" or "sidebar".
The value in this text box will be the title of the link to Installatron.
defaults are checked and "Installatron"
For control panel themes that support it, you can add individual apps to the "tabs" or "sidebar" section of the control panel by adding lines to this field.
To add single-application links enter the application's ID, then a space, then the text that will be shown in the tabs/sidebar for this application.
eg. "wordpress WordPress Toolkit"
default is no entries
Check to show the user's applications on their webhosting control panel dashboard, where supported by the control panel and theme.
default is enabled
The added section will look something like this:
Check to show applications that have been marked as featured (see Featured Applications below) on the user's webhosting control panel dashboard, where supported by the control panel and theme.
default is enabled
The added section will look something like this:
When either of the Dashboard checkboxes is checked a new block will be added to the user's control panel theme and the value of this field will be used as the title of he new block.
The second field is an optional URL to an icon to accompany the block's title. (32x32, any graphic format supported by web browsers)
default is "Applications" and the second value is automatically detected
Select where the "My Applications" and "Featured Applications" sections will be added to the user's webhosting control panel dashboard: "Top", "Middle", or "Bottom" of the dashboard content.
You can also enter a "Custom" value TODO... "1" adds a lot of apps to the block which is at its bottom position, "10" adds a low number of apps to the block, still in its low position -- not sure what "Custom" does?
default is "Bottom"
Select the source of featured applications.
"Automatic" will pull the list of applications from the highlighted applications in Applications: Access Control, and each Group (Administration: Groups) will also be listed here as a potential source. Finally, you can also enter a list of application IDs -- one ID per line -- to define a specific list of applications to highlight. For example:
wordpress mediawiki magento
default is "Automatic"
Select to have Installatron determine how many applications to highlight on the user's webhosting control panel dashboard.
Select to specify a maximum number of highlighted applications, then enter a value into the custom field.
Press the "Save All" button to save any changes you've made.
Configuration for all Installatron email activity, including changing of Installatron's notification templates.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
Select to have Installatron use PHP's mail() to send notifications.
Select to have Installatron use Sendmail to send notifications.
Select to have Installatron use SMTP to send notifications.
If "SMTP" is selected these additional fields appear:
The address of the SMTP mail server, in the form of an IP address or hostname.
default is "localhost"
The port used by the SMTP server.
default is "25"
The username to access the SMTP server.
The password to access the SMTP server.
Note that the existing password is not shown -- you need only enter value here if you wish to set a new password.
Check the actions that will result in a notification email be sent to the user.
These act as the default enabled notifications for new installs. Users can optionally change this selection during install and after the app is installed.
default is all checked
The email address that notifications will be sent From:.
Enter an optional address that all notifications will also be sent to.
Enter the email address that administrator reports will be sent to.
default is the administrative user's email address
"Use the user's default" will send notifications in the locale that the user has selected as their default webhosting control panel locale. Any other selection will send notifications in the specified locale.
default is all "Use the user's default"
This group of fields allows you to edit and customize the email notification templates.
Edit Template:Select the template you want to edit.
Select the language you want to edit.
Email Subject | |
Email Template
{app} = application {version} = version {url} = url to installed application {urladmin} = url to administration {details} = administration login, password, and email {detailsnopasswd} = administration login and email only |
Email Subject
Enter the Subject: of the notification email.
Email Template
Enter the body of the notification email.
Listed above the email template are the {tags} that can be used in the email body. These tags can also be used in the Email Subject.
Press the "Save All" button to save any changes you've made.
Configuration locale options, including the overriding of Installatron's strings.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
Choose between "Use the user's default locale", which tells Installatron to use the user's webhosting control panel locale setting, or specify a localization for Installatron to always use.
See the Installatron Translator tool for translation progress and to contribute to the locale projects.
Enter overrides for Installatron's locale strings: one override per line.
The format of each line is {string_key}={new string}. For example:
_tabs_myapplications=Override Value For All Languages _tabs_myapplications[en]=Override Value Only For English
The Installatron Translator tool can be used to generate these lines.
Press the "Save All" button to save any changes you've made.
Add a highlighted message to all user-level Installatron pages as a way to convey important information to your users of Installatron.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
Check to add the highlighted message of the day to each user-level Installatron page.
default is unchecked
Enter a title for the message of the day.
default is "Message Of The Day".
Enter the message of the day message.
default is "This is an example Message Of The Day."
Press the "Save All" button to save any changes you've made.
Configuration options for Installatron's user interface theme, including a place to add CSS overrides.
This dropdown field, at the top-right of each page, allows you to select which Group you're editing.
Groups inherit from their parent "Default" group unless they change a value in which case the field will change color to indicate that the group is overriding its default.
Check to to allow resellers to change the values on this page for their users.
Uncheck to force resellers and their users to use the values on this page.
default is checked
Check to allow Installatron to crop application names that don't fit into the allotted space on the Applications Browser tab.
Uncheck to leave the full application names even if it means a little overlapping of elements.
default is checked
Check " Yes, display an icon in the upper right corner" to add a button at the top-right of each Installatron page that returns you to the webhosting control panel dashboard.
Check " Yes, display a back button on each tab's navigation bar" to add a button at side of the toolbar on each user-level Installatron page.
default is the first checkbox checked, the second checkbox unchecked.
A template for linking to the file manager (relative to your control panel's URL), to a given folder within the user's account.
Check " Yes, display embedded links to an external file manager" to enable embedded file manager links.
Some tags that can be used here are:
{directory} path to folder being viewed (url encoded) {directory_nourlencode} a path to the target directory, relative to the user's home directory {session} control panel's session id {theme} control panel's theme name TODO?... anything else?
default is automatically detected for known control panels
A template for linking to the tool (usually phpMyAdmin) to view a given database.
Check " Yes, display embedded links to a MySQL database manager" to enable embedded database editor links.
Some tags that can be used here are:
{database} the name of the database to view {server} the server's domain {session} control panel's session id TODO?... anything else?
default is automatically detected for known control panels
A template for linking to the tool (usually phpMyAdmin) to view a given database.
Check to enable embedded database editor links.
Some tags that can be used here are:
{database} the name of the database to view TODO?... anything else?
default is automatically detected for known control panels.
Select for Installatron's default behavior to be embedded into the control panel's theme (where supported).
Select for Installatron's default behavior to be full screen, ignoring the control panel's theme.
default is "Embedded".
Select the Installatron theme to use when it is full screen: "Modern", "Classic", "Simple".
default is "Modern".
Enter custom CSS for Installatron to use on all Installatron pages.
Tip: Web browsers like Firefox, Chrome, and Edge include developer tools that make it easy to experiment with CSS changes and develop a set of edits that you can paste into this field to give Installatron a touch of your service's personal theming.
Tip: All of Installatron's CSS classes begin with "#i_installatron".
For example:
#i_installatron { background: #ffe; }
Press the "Save All" button to save any changes you've made.
Multi-Server allows you to easily share a single Installatron configuration across multiple servers.
A single server is referred to as a standalone server, and this is the default server behavior.
A server that shares its configuration is called a master server.
And a server that takes its configuration from the master server is called a slave server.
Multi-server works by having the Master server upload a copy of its configuration to a shared location once per day. The Slave servers then sync with that centralized config each time Installatron's update/repair is run (once per day by crontab or any time the +run Installatron Update/Repair button is pressed in the administration UI).
Note that Multi-Server will synchronize all settings system-wide except for the 'General' and 'Libraries' sections of Administration: Settings. Therefore, Multi-Server requires the master server to be setup in such a way that its configuration can be used without modification by slave servers. For example, if one slave server requires a special group configuration, the configuration must be added to the master server and from there is inherited to the slave server.
Select to keep this as a server that doesn't share its configuration and doesn't take its configuration from another server.
Select to make this a server that shares its configuration.
Select to make this a server that takes its configuration from another server.
default is "This server is a standalone server"
When "This server is a master server" is selected you will be prompted with these additional fields:
Shows "Not Configured" if you have not yet saved a remote location to upload the server's configuration to.
Otherwise it will show the URL of the server's configuration (which is then used by Slave servers).
Select the method that this server will use to upload the configuration to the shared location.
Tip: if you find that one protocol doesn't work then try another. Not all protocols will work on all servers.
The "WordPress" protocol is a special method, available only to WordPress applications, which requires only the application's administrative username and password values. Installatron will use these two install a temporary plugin on the app which is then used to automatically migrate the website to the destination location. The plugin is automatically removed at the end of a successful migration.
Username
The administrative username of the WordPress application.
Password
The administrative password of the WordPress application.
These remote connection systems/protocols all use the same values, described here.
Note that SSH is the ideal protocol to use, though unfortunately not all webhosting services have it enabled for users to make use of. The various FTP options can be hit-and-miss depending on the webhosting service.
Server (IP Address or Hostname)
The address of the server where backups will be stored.
If you don't know the IP address of the web hosting account try entering the domain in the form domain.com (without www. or http://)
Port
The port used to connect to the server for the selected protocol.
Typical values are: 21 for FTP and FTP with TLS/SSL, 22 for SFTP, or 443 for WebDAV.
Username
The FTP or WebDAV account's login name.
Password
The FTP or WebDAV account's login password.
Path
The folder to store the configuration files. Default is the top level folder.
The path value is difficult to describe because it depends on a combination of the Protocol that you have selected and how the source application's server is configured.
If you don't already know the correct path for your source application's server then start by creating a file named "showpath.php" in the source application's main directory and give the file this content:
<?php getcwd(); ?>You can then view that script from:
http://{YOUR_DOMAIN}/{POSSIBLE_SUB_DIRECTORY}/showpath.phpThat will show you the full server path to the location of the source application's files. It might look like one of these examples:
/home/myaccount/domains/mydomain.com/public_html (typical DirectAdmin example) /home/myaccount/public_html (typical cPanel main domain example) /home/myaccount/public_html/myaddondomain.com (typical cPanel addon domain example) /home/myaccount/myaddondomain.com (typical cPanel addon domain example) /var/www/vhosts/mydomain.com/httpdocs (typical Plesk domain example) /var/www/vhosts/sub.mydomain.com/httpdocs (typical Plesk sub-domain example) /home/myaccount/domains/mydomain.com/public_html/subdir (typical example subdirectory) /home/myaccount/public_html/subdir (typical example subdirectory) /home/myaccount/public_html/myaddondomain.com/subdir (typical example subdirectory) /home/myaccount/myaddondomain.com/subdir (typical example subdirectory) /var/www/vhosts/mydomain.com/httpdocs/subdir (typical example subdirectory)
The next step is to identify where your SSH or FTP login logs in -- it needs to be somewhere along that path to be usable.
The value of "Path" is then the the remainder of the path from where the login logs in to the end of the path.
For example, if an SSH login on a DirectAdmin server logs into the "/" (server root) then the Path value for the example above will be the full "/home/myaccount/domains/mydomain.com/public_html" or "/home/myaccount/domains/mydomain.com/public_html/subdir" path.
Or if an FTP/S login on a cPanel server logs into the above example addon domain's home directory then the Path value will be "/myaddondomain.com" or "/myaddondomain.com/subdir".
Or if a WebDAV login (on any server type) logs in directly to the application's directory then the Path value will be just "/".
You will be prompted to authorize Dropbox or Google Drive access upon saving this form.
Rackspace Region
(3-letter)
You can find information about Rackspace Region at https://docs.aws.amazon.com/general/latest/gr/s3.htmlRackspace Container
The name of the container where backups are to be stored.
Rackspace Username
The username utilized to authenticated the Rackspace Container.
Rackspace API Key
The API key utilized to authenticated the Rackspace Container.
Rackspace Container Directory (Optional)
Optional directory under the container which backups are to be stored.
S3 Endpoint
e.g., "s3.us-west-1.amazonaws.com"
You can find information about S3 endpoints at https://docs.aws.amazon.com/general/latest/gr/s3.htmlS3 Region
e.g., "us-west-1"
You can find information about S3 regions at https://docs.aws.amazon.com/general/latest/gr/s3.htmlS3 Bucket
The name of the bucket where backups are to be stored.
AWS Access Key
The access key utilized to authenticate the S3 Bucket.
AWS Secret Key
The secret key utilized to authenticate the S3 Bucket.
S3 Bucket Directory (Optional)
Optional directory under the bucket which backups are to be stored.
When "This server is a slave server" is selected you will be prompted with these additional fields:
Enter the URL to the configuration files given by the Master server's Multi-Server setup.
Press the "Save All" button to save any changes you've made.
List Builder is used to build lists of the applications that are available to install on your server (via Installatron). These lists can be incorporated into your website.
This tool can be used to build everything from a simple text list to a full UI like the Applications Browser found in Installatron.
For more information and examples see Tutorials: List Builder.
Check to enable this feature and have List Builder build application list(s).
Check to have List Builder refresh the list(s) after each Installatron Update.
Check to have List Builder only include the latest version of each application in the list(s).
Enter a path to where the file(s) will be created.
Enter a template for List Builder. A list of available {tags} are below this field.
default is "<li><a href='{url}'>{script}</a> v{version}</li>"
Press the "Save All" button to save any changes you've made.
Tip: The file(s) can be refreshed at any time by going to the Administration: Installatron and pressing:
Live Demo Server allows you to create a local instance of Live Demo, which is a large installation of all major branches of all applications that are currently supported by Installatron. The purpose of Live Demo is for users to be able to test applications before committing to installing the app on their account.
Live Demo is always available from https://livedemo.installatron.com, where all installs are reset daily (sometimes more often), and we recommend utilizing Installatron's instance of Live Demo where possible. All links to Installatron's instance of Live Demo from Installatron are branded with your URL, so your users won't know they're leaving your service.
But this feature is here if you wish to build Live Demo locally and have your users use that instead. Live Demo Server will require approximately 15 databases and 2GB of disk space at any given time (dependent upon which applications are activated).
Check to enable the building and maintenance of Live Demo on the server where this feature is enabled.
Note: Enabling this feature only builds the applications, it doesn't tell this server to use the new live demo service. To tell this server (or any of your servers to use this new instance of Live Demo) you need to also copy the URL from "Live Demo URL" (see below) into Applications: Live Demo.
default is unchecked
Enter a control panel account to host Live Demo installations.
This should be an account dedicated to this purpose, and if possible the account should be allocated unlimited disk space and databases.
Enter a URL served by the above Control Panel Account that will used to host Live Demo installations.
And remember to copy this value to Applications: Live Demo to have this server use the local instance of Live Demo.
Press the "Save All" button to save any changes you've made.
Converter imports existing applications into Installatron. It can find applications by looking at other auto-installer data files (cPanel cPAddon Scripts, CPSkins PSA-Installer Pro, Fantastico De Luxe, Plesk Power Pack (Application Vault), Softaculous Script Installer) and by searching user's directories for supported applications.
This tool can be run multiple times if necessary. Existing installed applications won't be adversely affected.
Tip: Users can also import individual apps from their account into Installatron using the Import Wizard feature.
Select to search user's accounts for recognized applications.
Select to skip the directory search.
default is "Yes"
Select to remove applications from the auto-installer that currently maintains the application after it has been imported into Installatron. (recommended)
Select to leave the original auto-installer managing the application alongside Installatron. Note that this option may cause conflicts between auto-installers.
default is "Yes"
Press the "Convert Installed Applications" button to run Converter.
Access Installatron's logs via UI.
The same logs can be found in /var/installatron/logs/.
Click to reset all logs.
debug_log
The debug log, when enabled, keeps a very detailed log of all Installatron's activity.
Debug logging is enabled by adding debug=yes to Installatron's primary configuration file:
/usr/local/installatron/etc/settings.iniNote: You SHOULD NOT leave debug logging enabled when you are not trying to find the cause of a problem because debug logging has a severe impact on Installatron's performance.
error_log
Logs PHP errors and warnings.
fetch_log
Logs HTTP calls made by Installatron.
filesystem_log
Logs some filesystem actions.
install_error_log
Logs errors that occur during actions (eg. install, update, clone, etc).
mail_log
Logs notifications sent to users.
panel_log
Installatron Plugin only
Logs interactions with the webhosting control panel's plugin API.
plugintheme_log
Installatron Plugin only
Logs interactions with and actions involving the webhosting control panel's theme.
repair_crontab_log
Logs the automated Installatron update/repair processes that are run by the Installatron crontab task.
repair_fetch_log
Logs HTTP calls made during the automated Installatron update/repair processes.
repair_filesystem_log
Logs some filesystem action made during the automated Installatron update/repair processes.
task_log
Log of tasks initiated by Installatron.
Tip: a good approach to contacting Installatron support is to first reset the Installatron logs; then perform the task that causes the problem; and then zip up the contents of /var/installatron/logs/* and either attach the zip to the Installatron ticket (if the zip is small enough to attach), or put it online somewhere and include the download link in the ticket.