How to install a Webasyst app

In order to install a Webasyst app, you need to install Webasyst framework first. Apps cannot be installed without the framework.

Webasyst framework can be installed on any modern hosting service with the support for PHP and MySQL and satisfying the system requirements, or on a local web server. If you are going to install Webasyst on your local machine, and don't have a web server software, we recommend installing Apache + PHP + MySQL bundle with an all-in-one package such as XAMPP (Windows, Mac OS X).

Note: Use of Nginx + FastCGI combination without Apache requires some extra web server setup.

1. Webasyst framework installation

  1. Download Webasyst:
  2. Extract the package contents on your computer and upload its contents to the remote server's directory via FTP, where PHP scripts should be installed (for local installation copy all files from the archive to htdocs folder on your XAMPP installation). The contents of the installation directory must be accessible via HTTP: at a URL of the form
    It is strongly advisable to install the framework into an empty directory which does not contain files of other software products or websites. Failure to comply with this requirement may have unpredictable results.
  3. Change permissions for the installation directory and subdirectory wa-installer/ so that the operating system user executing PHP scripts is allowed to save/modify files in those directories. Files index.php and install.php must be writable by the web server. As a rule, one of the following standard values should be sufficient for directories: 755, 775, or 777, and 644, 664, or 666 for files respectively. The exact permission values can be requested from your web-hosting provider or web server administrator.
  4. Create a MySQL database in your web-hosting control panel and grant full access for a MySQL user to the newly added database. Copy or otherwise note the MySQL user name, database name, and the MySQL server (host) name displayed in your web-hosting control panel.
  5. Type the URL in your browser address bar, at which the framework should be available after the installation. For example, if extracted installation files were uploaded in step 2 to a directory named public_html, html, htdocs, or httpdocs, then type the domain name (or IP address) associated with your web-hosting account.
  6. Follow the instructions of the installation wizard. When requested, paste (or type in) previously copied (noted) MySQL server name, database name, and MySQL user name in the provided text fields. After submitting database connection credentials, click on the single available link on the page to enter your Webasyst account.
  7. Specify the main user's details: login name, password, and email address. Then click on “Enter”. Upon successful first login to your Webasyst account, installation of the framework is considered completed.

If a click on the “Enter” link brings you to page with the “Internal Server Error 500” message, edit file .htaccess in the framework installation directory by removing comment symbol # at the beginning of the following line:

#RewriteBase /

If the framework is being installed in a subdirectory of your domain name (e.g., at, then add the relative path to its installation directory to the slash symbol at the end of the line as shown below:

RewriteBase /webasyst/

2. App installation

Using Installer (recommended)

Framework contains a system application called Installer which is used for installing software updates or also installing new applications from the Webasyst repository (and deleting them). Use the Installer to add the desired app to your backend.

Clients of the Webasyst cloud can use only this installation option.

Manual installation

In order to install an application without using Installer, follow the instructions below.

  1. Download the desired application's installation package.
  2. Extract the contents of the installation package (archive) to framework directory wa-apps/. Once all files are uploaded, a new subdirectory will appear which will contain the file structure of the application being installed. The name of the new subdirectory matches the unique identifier (APP_ID) of the application.
  3. To make the new application's icon appear in the main menu, enable it in system configuration file wa-config/apps.php by adding the following line:
    '{APP_ID}' => true,
    Specify the new application's identifier instead of {APP_ID}.


    Add comment

    To add a comment please sign up or login