Installation Guide

Preparation

To get started with Deepwater, decide how you want your development environment setup. It's possible to install Deepwater by first installing git but this tutorial will cover the most common installation method for simplicity. The install guide assumes Deepwater is being installed on a CPanel shared environment. Contact your hosting provider if you need assistance preparing the website's environment.

  • 1. Download Deepwater and extract the contents of the zip file.
  • 2. Upload the files from the extracted Deepwater-2-master folder using FTP. Place the files in the web root or a desired sub directory.
  • 3. On Cpanel's MySQL Databases page, Create a database for Deepwater. Then add a new user. Next, add the new user to the database, use all privilages. Take note of the created database name, full user name, and password.
  • 4. Navigate to the public address where the Deepwater files were uplaoded to. You should be redirected to the install script.
3 Step Installation

The following three steps are all that is needed to install Deepwater. In the first step, Deepwater will test for needed dependencies to operate correctly. Check the troubleshooting section below or contact your hosting provider if a dependency fails.

Note: Less common, self managed servers will need mod_rewrite and mod_headers modules installed. In addition, php files should be run as the cpanel user and not the default nobody user.

  • 1. Ensure that the requirements pass on step 1 of the installation process.
  • 2. The second step is for the database configuration. Input the database username, password, and database name. The additional options can be left at the default settings or changed as needed.
  • 3. The final step is to create an admin account. Input a name, email address, and passphrase. By default, the admin account will be given full privileges in Deepwater.

For improved security, check that the permissions of the install.php file were successfully changed to 0200 after the installation.

Installation Troubleshooting
  • PHP 5.3.3 Failed It might be possible to override the PHP version through the .htaccess file at your web host. Check with your hosting providor to see if they offer a way to enable PHP version 5.3.3+ needed to install this framework. Deepwater was successfully installed on Hostgator by following thier PHP 5.3 instructions.
  • Forgot Install Password Presently, the admin password can't be recovered and the installation must be redone. To start clean, first change the permissions of the install.php file to 0644 or higher if needed. Next, delete the configuration.inc.php file found in the core/includes directory. Finally, drop all tables present in the Deepwater database using PHPMYADMIN or similar. Afterwards, begin the installation again starting at the last step in the preparation section.