One-click installation (for web hosting companies)

One-click Webasyst installation: a guide for hosting providers


If your company provides web hosting services, we encourage you to offer your clients the one-click installation feature to quickly set up the Webasyst framework!

It is relatively easy to configure, and the framework is indeed installed in one mouse click: it takes only to choose the installation directory and to click on the "Install" button. Extraction of the distribution archive, setup of the database connection, assigning of the necessary permissions to files and folders — all this is completed automatically. Your clients would not need to download and extract the distribution archive, upload files via FTP, assign permissions, create a database, or specify database connection credentials.


One-click installation of the Webasyst framework is available by means of software library Softaculous, which supports integration with popular web hosting control panels cPanel, Plesk, H-Sphere, DirectAdmin, and InterWorx. View information about Webasyst on the Softaculous website at

If you do not use Softaculous in your web hosting company, then the implementation of the one-click installation feature will depend on the specific architecture of your company's control panel software. The general idea is to write a plugin (add-on) for your control panel, which should be able to perform the following actions:

  1. Download the framework distribution archive from the Webasyst server accessible at (approx. 3 MB). This is a special framework version prepared for one-click installation. It differs from the basic version available on the website only through the installation method. The specified URL is always pointing to the latest version of the Webasyst framework containing applications Site, Blog, Contacts, and Stickies.

    You may set up caching of the distribution archive at your discretion.

  2. The downloaded distribution archive must be extracted into the installation folder chosen by the user.

    We suggest you implementing the installation folder selection interface by taking advantage of the available features of your control panel software.

  3. Set file write permissions for a) the Webasyst root installation directory and b) all files and subdirectories inside it. PHP scripts must have file write access to all Webasyst directories to ensure that your clients can add new applications at any time (applications are downloaded from the Webasyst server and are also installed in one mouse click).

    It is essential to allow the user of your server's operating system, under which Apache is running, to have full access to all files of the framework. If it is not possible for some reasons, then at least the following three subdirectories should be created and assigned full permissions: wa-cache, wa-data, wa-log. (It is important to be aware that in this case, due to insufficient permissions for directory wa-apps, installation of new applications using the Webasyst Installer will not work.)

  4. Create a database for the framework and configuration file wa-config/db.php with the following contents:

    return array(
        'default' => array(
            'host' => 'HOST',
            'user' => 'USER',
            'password' => 'PASSWORD',
            'database' => 'DATABASE',

    If you decide to skip this step, then the user would have to create a database and enter connection credentials during the setup. This would definitely be not a one-click installation at all.

  5. Forward the user to the root installation URL http://INSTALLATION_URL/
    The user will see the Webasyst backend login screen and will be offered to enter a login name and a password (i.e. to sign up) in order to enter the backend.