Installation

Six steps. No SSH. About six minutes.

This is the whole process on a standard cPanel account, with nothing left out and nothing assumed. If you have ever installed WordPress by hand, this is easier, because the wizard checks your server before it writes anything and tells you which cPanel screen to open if something is wrong.

The install

Start to finish.

1

Check your server, 30 seconds

Upload gyro-check.php to public_html and open it in your browser. Every requirement is listed with a pass or fail and, where something fails, the exact cPanel screen that fixes it. The checker deletes itself when you are done.

2

Upload and extract, 2 minutes

In cPanel File Manager, upload gyro-suite-1.0.4-php83.zip to your target folder and use Extract. Roughly 40 MB, so it takes a moment on a slow connection. No Composer, no npm, no build step: the archive contains everything, already built.

3

Create an empty database, 1 minute

cPanel, MySQL Databases. Create a database, create a user, and add that user to the database with All Privileges. Keep the three values on screen. Do not import anything, the installer builds the schema.

4

Run the wizard, 2 minutes

Open your domain in a browser. The wizard re-runs the checks, takes the database details, then your licence key, then your first company: name, country, base currency, fiscal year start and a chart of accounts template. Then your administrator account.

5

Add one cron line, 30 seconds

cPanel, Cron Jobs, once per minute. Paste the exact line the wizard shows you. Then press Verify cron in the wizard and wait up to sixty seconds for it to turn green. Skipping this is the single most common cause of a broken installation.

6

Load demo data, or do not

The last screen offers a sample dataset in one of three shapes: services agency, trading company or light manufacturer. It is the fastest way to see the product working, and it can be wiped in one click before you go live.

What the checker actually is

A single PHP file, about 12 KB, that prints a table. It makes no network connection, writes nothing to disk, touches no database and reads no file other than your PHP configuration. It offers to delete itself when you have read the result, and if you would rather not run it at all, everything it checks is listed on the system requirements page so you can verify it manually in cPanel.

# The one cron line, exactly as the wizard gives it to you
* * * * * /usr/local/bin/php /home/yourusername/public_html/artisan schedule:run >/dev/null 2>&1

# cPanel: Advanced -> Cron Jobs -> Common Settings -> Once Per Minute
# The wizard prints your real path. Copy it from there, do not type this.
If something goes wrong

The four problems that actually happen.

In that order of frequency. Every one has a fix that takes under two minutes.

ionCube Loader not found

The most common by far. In cPanel, open Select PHP Version, find ioncube_loader in the extensions list and tick it. If it is not listed, open a ticket with your host asking them to enable it; it is a standard extension and they will.

Cron never turns green

Usually the PHP binary path. Some hosts need /usr/local/bin/ea-php83 rather than /usr/local/bin/php. The wizard shows the alternatives it detected, and the Health page tells you the moment cron stops running later on.

500 error after extracting

Almost always file permissions or a stale opcache. Set folders to 755 and files to 644 in File Manager, then wait sixty seconds for opcache to clear. If it persists, the error is written to storage/logs with a code you can send us.

Cannot connect to database

On cPanel the database and user names are prefixed with your account name, so it is myaccount_gyro rather than gyro. Copy them from the MySQL Databases screen rather than typing them, and confirm the user is attached with All Privileges.

Afterwards

The first fifteen minutes of a new installation.

Do thisWhyTime
Set up outgoing emailNothing sends until it is configured. Use your own SMTP, not the server's mail function3 min
Turn on scheduled backupsPick a destination and a retention period. Then test a restore, once, properly3 min
Review the chart of accountsThe country template is a starting point. Adjust it before you post anything5 min
Set document numberingPrefixes and starting numbers per document type. Changing them later is awkward2 min
Create roles for your teamStart from Admin, Manager, Accountant, Sales, Support, HR and Employee templates2 min
Switch off modules you will not useFewer menus, less to learn. Nothing is deleted and you can re-enable any time1 min
Questions

About installing and updating.

Can you install it for me?

Yes. Our installation service is a one-off fee and covers the install, SSL check, email configuration, cron verification, your first company setup with the right chart of accounts, and a data import of your customers and open invoices. It typically completes within one business day of you sending the hosting details. Ask through the contact form and choose Installation service.

How do updates work later?

One click from Settings, Updates. It shows you the changelog, forces a backup, downloads, verifies a checksum and a signature, puts the site in maintenance mode, runs migrations in chunks that survive a shared host time limit, clears caches and comes back. If any step fails it restores the pre-update backup automatically and reports a stable error code.

Can I install it twice, for testing?

Yes. Every licence includes one non-production installation at no extra cost. Point it at a subdomain such as staging.yourcompany.com and activate with the same key. Local installations on localhost or a .test domain are always free and do not consume anything.

What if I want to move it to another host later?

Copy the files, export and import the database, then deactivate the licence on the old domain and activate on the new one. You do not need to contact us and you do not need to remember the old domain, only your key. The full procedure is on the licence page.

Get your licence key.

Fourteen days, the complete product, no card. The key arrives by email within the hour.