Shared Hosting (cPanel)

Classic FTP Installation

FoxDesk uses an intuitive installation wizard mechanism designed to mirror the straightforward setup style of platforms like WordPress. The installation process typically takes less than 5 minutes.

Step 1: Uploading Files

Download the latest FoxDesk package (.zip archive). Unzip the package and use the cPanel File Manager, or your favorite FTP client, to copy the entire extracted structure into your public web root directory (public_html/ or /public folder).

Important: Ensure your FTP client transfers hidden files so the .htaccess file is uploaded successfully!

Step 2: Database Preparation

Within your hosting dashboard (e.g., cPanel MySQL Databases):

1. Create a new blank database (e.g., helpdesk_db).
2. Create a new MySQL user and assign a strong password.
3. Grant the user All Privileges to the newly created database.

Important: Write down the database name, username, and password. You will need these details during the web installation in the next step!

Step 3: Run the Web Wizard

Navigate to https://yourdomain.com/install.php using your web browser.

1. In the first step, enter your database host (usually localhost), port (3306), and the database user, password, and database name you just created and saved in Step 2. Click “Connect”.
2. Set up your basic helpdesk settings (Application Name) and create your initial admin account credentials.
3. The wizard will securely generate your config.php, build the required database schemas, and seed initial priority/status values.

Once completed, you will be redirected to the login screen. It is highly recommended to permanently delete install.php from your server immediately after installation to maintain security.