Skip to Content

Installing Laravel Bagisto on Shared Hosting (Without Command Line) 2025

Bagisto 2.2 Installation on Shared Hosting (GUI-Based) 2025

This document provides step-by-step instructions for installing Bagisto 2.2 on a shared hosting environment without modifying any files and using only the GUI interface.

System Requirements

Before installing Bagisto, ensure that your shared hosting meets the following requirements:

  • PHP Version: 8.1 or higher
  • MySQL Version: 5.7 or higher / MariaDB 10.2+
  • Composer: Required for package management (optional for GUI-based installation)
  • PHP Extensions Required:
    • BCMath
    • Ctype
    • Fileinfo
    • JSON
    • Mbstring
    • OpenSSL
    • PDO
    • Tokenizer
    • XML
    • GD (for image processing)
  • Mod_Rewrite: Enabled on Apache server

Step 1: Download and Upload Bagisto

  1. Download the latest Bagisto 2.2 ZIP from GitHub:
  2. Extract the ZIP file on your local computer.
  3. Log in to cPanel > File Manager.
  4. Navigate to the public_html folder (or a subdirectory if required).
  5. Click Upload and select the extracted Bagisto ZIP file.
  6. Once uploaded, extract the ZIP file inside public_html.

Step 2: Create a Database in cPanel

  1. Go to cPanel > MySQL Databases.
  2. Click on Create New Database and name it (e.g., bagisto_db).
  3. Scroll down to MySQL Users and create a new user (e.g., bagisto_user).
  4. Assign the user to the database and grant All Privileges.
  5. Save the database name, username, and password for later use.

Step 3: Run the Bagisto GUI Installer

  1. Open your browser and visit:
    yourdomain.com/public
  2. The Bagisto Installation Wizard will appear.
  3. Follow the on-screen steps:
    • Step 1: Welcome Screen → Click Continue.
    • Step 2: Server Requirements → Ensure all checks are ✅, then click Continue.
    • Step 3: Folder Permissions → Ensure all necessary folders are writable, then click Continue.
    • Step 4: Database Configuration → Enter the database credentials you created earlier.
    • Step 5: Admin Configuration → Enter your admin name, email, and password.
    • Step 6: Installation → The system will automatically configure the database and set up Bagisto.
  4. Once installation is complete, click Finish.

Step 4: Access Your Store & Admin Panel

  • Frontend Store:
    yourdomain.com/public
  • Admin Panel:
    yourdomain.com/public/admin
    • Log in with the admin email & password you set during installation.

Step 5: Remove /public from the URL (Without File Modifications)

If you want to access Bagisto from the root domain without modifying Laravel files, follow these methods:

Method 1: Using .htaccess (Recommended)

  1. Open cPanel > File Manager and navigate to public_html.
  2. Locate and edit the .htaccess file.
  3. Add the following lines at the top:
    <IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_URI} !^/public/
    RewriteRule ^(.*)$ /public/$1 [L]
</IfModule>
  4. Save the file.

Method 2: Using cPanel Redirect

  1. Go to cPanel > Domains > Redirects.
  2. Select Permanent (301) Redirect.
  3. Set up the redirect:
    • Domain: yourdomain.com
    • Redirects to: yourdomain.com/public
    • Redirect with or without www → Select Yes.
  4. Click Add Redirect.

Now, when users visit yourdomain.com, it will automatically redirect to yourdomain.com/public without modifying Laravel files.

Troubleshooting Common Issues

1. 500 Internal Server Error

  • Ensure .env has correct database credentials.
  • Delete files in bootstrap/cache and refresh the page.

2. CSS/JS Not Loading

  • Run php artisan storage:link (use a PHP script if SSH is not available).
  • Ensure .htaccess rewrite rules are correctly set.

3. White Screen (Whoops! Something Went Wrong)

  • Edit .env file and set APP_DEBUG=true, then refresh to see error details.

4. Symlink is Disabled Issue

  • If your hosting provider has symlink functions disabled, try using a storage workaround by manually copying assets:
    1. Open public folder and create a new storage folder.
    2. Copy all files from storage/app/public to public/storage.
    3. Update the APP_URL in .env to reflect your domain.

5. Migration & Database Errors

  • Ensure database tables are created properly.
  • If errors persist, delete all tables and restart the installation process.

Conclusion

By following this guide, you can install Bagisto 2.2 on shared hosting using only the GUI installer, without modifying any Laravel files. The .htaccess method ensures users can access the store from the domain root without needing to alter core Laravel configurations.

If you need further assistance, feel free to reach out! 🚀

Preventing Accidental Pushes to Upstream Repository (2025 Guide)
Steps to Prevent Accidental Pushes