INSTALL GUIDE

Install GSM Grow on your domain.

Upload the package, point the domain at its public folder and finish the web installer. No command line needed on ordinary shared hosting.

Before you start

Shared hosting (cPanel, hPanel, Plesk) or a VPS. The zip already includes its libraries and built files, so you don't need Composer, Node.js or SSH.

PHP: 8.4 or newer, with PDO, Mbstring, OpenSSL, Tokenizer, XML, Ctype, JSON and BCMath (plus cURL, DOM and Fileinfo, which most hosts enable)
Database: MySQL 8.0+ or MariaDB 10.6+, one empty database
Web server: Apache with mod_rewrite, LiteSpeed or Nginx
Disk space: 200 MB or more, plus room for media, logs and backups
HTTPS: An SSL certificate on the store domain
Scheduler: A job that runs every minute: a hosting cron job or a free cron-job.org account
License: A key claimed for your final domain at portal.gsmgrow.com

PART 1

01
Download the package
Sign in at portal.gsmgrow.com, open your license and download the latest zip. Keep the license key ready for the installer.
02
Upload and extract
Upload the zip to your hosting and extract it. Every folder must be present, including public, storage, vendor and bootstrap.
03
Point the domain at public
Set the document root of the domain to the public folder inside the package, not the folder above it. In cPanel or hPanel this is under Domains → Document root.
04
Make two folders writable
Give the web server write access to storage and bootstrap/cache (775 on most hosts). Use File Manager → Change Permissions if you have no SSH.
05
Create an empty database
Create a MySQL or MariaDB database and a user with full access to it. Note the host, database name, username and password.

$ chmod -R 775 storage bootstrap/cache

PART 2

Open https://your-domain.com/install. Visiting the domain also takes you there until the store is installed.

01
Welcome
A server checklist: PHP version, extensions and writable folders. Fix any failed item in your hosting panel and reload.
02
License
Paste your license key and the domain customers will use, without https://. Install continues once the license is activated.
03
Database
Enter host, port (3306), database name, username and password. On shared hosting the host is usually localhost.
04
Application
Set the store name and colour, choose whether to load demo products and banners, and create the admin account.
05
Crons
Choose your hosting and copy the cron command, or use a free cron-job.org account. You can also set this up later.
06
Done
The installer writes the configuration, creates the tables and locks itself. Open the admin panel at /admin.

Don't skip the scheduler for long. Without it, catalog sync, supplier order checks, automatic updates and backups don't run.

Problem	What to check
500 error or blank page	Permissions on storage and bootstrap/cache, then storage/logs for the error
Installer stuck on Welcome	PHP 8.4+ and the missing extension named in the checklist
License activation failed	The key, and that the domain matches the one in your portal
Database connection failed	Credentials, and that the database exists and is empty; use localhost on shared hosting
Pages load without styles	The public/build folder was not uploaded; upload it again

Your reseller can install the store for you, or write to sales@gsmgrow.com.