cPanel Installation

​

Getting Started with SaasCart API Deployment

​

1. Prepare Files for Upload

• Open the saascart-api directory that you downloaded from SaasCart.
• Zip all files and folders in the saascart-api folder, creating a .zip file for upload.

​

2. Create Subdomains

• Log in to your cPanel account and go to Domains > Subdomains.
• Create separate subdomains:
  • store.your-domain.com for the Next.js frontend
  • api.your-domain.com for the Laravel API
  • admin.your-domain.com for the Next.js backend

​

3. Upload and Extract the Zip File

• Upload the saascart-api.zip file to the File Manager in the api.your-domain.com directory.
• Once uploaded, click Go Back and extract the .zip file.

​

4. Create a MySQL Database

• In cPanel, go to MySQL Database Wizard to create a new database.
• Set up a new database user and assign the user to the database with all necessary permissions.
• Take note of the DB_DATABASE, DB_USERNAME, and DB_PASSWORD for later.

​

5. Update the Environment File

• Open the .env file in the api.your-domain.com directory.
• Update the following values:
  • APP_URL=https://api.your-domain.com
  • APP_ENV=production
  • DB_DATABASE=your_db_name
  • DB_USERNAME=your_db_username
  • DB_PASSWORD=your_db_password

​

6. Open cPanel Terminal

• Search for Terminal in cPanel, or use SSH access if terminal access is unavailable in cPanel.
• Navigate to the Laravel project root directory.

​

7. Install Required Dependencies

Run the following command in the api.your-domain.com directory:

composer install

​

8. Generate Laravel APP Key

Generate the Laravel app key by running:

php artisan key:generate

​

9. Set Up the Database in phpMyAdmin

Before running the SaasCart installation command, set up your database using phpMyAdmin.

1. Open phpMyAdmin: Go to http://your-domain.com/phpmyadmin.
2. Select Your Database: Choose the database you created in Step 4 (e.g., saascart_db).
3. Import Data:
   • For a pre-configured setup, choose the saascart_dummy_data.sql file to import sample data.
   • For a clean setup, select saascart_no_data.sql to import only the essential structure.

​

10. Link Storage Folder to Public Folder

Run the following command to link storage and display images correctly:

php artisan storage:link

​

Congratulations

​

Additional Resources

• If you’re encountering issues with loading the API, you may need to verify your .htaccess configuration. Ensure your .htaccess file includes the following rules:

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^(.*)$ public/$1 [L]
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

• Laravel Official Documentation: Refer to Laravel Documentation for deployment best practices.
• cPanel Documentation: Check cPanel Documentation for server management tips.
• Hosting Provider Guides: Your hosting provider may offer specific Laravel deployment documentation.