On a remote server

Contents...

For installation of Webasyst scripts, your server must support PHP and MySQL versions specified in the system requirements.

  1. Connect to your web-hosting server using an FTP client; e.g., FileZilla. Instead of FTP access, your web-hosting company may offer a special file manager in your control panel or SSH access. When connected to the server, select the directory used for uploading website files; e.g., public_html, html, htdocs, or httpdocs (if you have doubts, ask your web-hosting company's support team to be sure).

  2. Extract the contents of the installation archive into any empty folder on your computer and upload its contents to the selected directory on the web server.

    It is strongly recommended to install Webasyst into an empty directory, which does not contain files of other software products. Failure to fulfill 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.

    To find out the exact permission values, consult your 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; you will need these data later during the installation of Webasyst.

  5. Type the URL in your browser address bar, at which Webasyst scripts 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; e.g., http://yourdomain.com/ or http://111.222.333.444/.

  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, the installation is completed.

Non-standard server setup

Use of nginx as web server in FastCGI mode

Use of combination nginx + FastCGI without Apache for framework installation requires special setup.

Internal Server Error 500

RewriteBase

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

#RewriteBase /

After deletion, this line will look as shown below:

RewriteBase /

If Webasyst is being installed in a subdirectory of your domain name (e.g., at http://yourdomain.com/wa/), then add the relative path to its installation directory at the end of the line as shown below:

RewriteBase /wa/

Options -MultiViews

On some servers, use of the following directive in file .htaccess may cause error 500:

Options -MultiViews

In this case, add the # character at the beginning of the line to avoid this error:

#Options -MultiViews