POS User Guide Docs

Installation & setup

This page gets the POS running on your own hosting. You'll check your server meets a few simple requirements, upload the files, then follow a friendly on-screen wizard that does the hard parts for you. Most installs take about 10 minutes — no coding required.

You only do this once

Installation is a one-time setup. If someone already installed the POS for you, you can skip straight to Getting started.

Before you start: what you'll need

Have these ready. If you're not sure about the server details, your hosting provider's support team can confirm them in a minute.

Web hosting

Any standard web host works — including cheap shared hosting (cPanel, Plesk). A VPS is fine too.

A database

One empty MySQL database, with its name, username and password. Create it in your hosting panel.

Your purchase code

The license / purchase code you received when you bought the POS — needed to activate it.

Server requirements

The installer checks all of this for you automatically (see Step 2 below) and shows a green tick or a red cross with a fix for each item. Here's the short version:

RequirementNeededNotes
PHP version8.2 or newerMost hosts let you pick the PHP version in the control panel.
MySQL8.0+MySQL 5.7 also works as a fallback.
PHP extensionsStandard setbcmath, ctype, curl, dom, fileinfo, gd, json, mbstring, openssl, pdo_mysql, tokenizer, xml, zip, intl — almost always already on.
Memory limit128 MB+256 MB recommended for smooth imports.
Writable foldersYesThe installer needs to write to storage/, bootstrap/cache/ and public/uploads/.
Internet accessRecommendedFor license activation and update checks. An offline activation path exists if your server is firewalled.
No special software needed

You don't need Node, Redis, Composer, or any background services. The POS is built to run on ordinary shared hosting out of the box.

Installing, step by step

  1. Create an empty database

    In your hosting control panel (cPanel/Plesk), create a new MySQL database and a database user, and give that user access to the database. Write down the database name, username and password — you'll type them in shortly.

  2. Upload the files

    Unzip the product download and upload its contents to your website folder (usually public_html) using your host's File Manager or an FTP app. Point your domain at this folder.

  3. Open your website

    Visit your domain in a browser. The first time, it automatically opens the installer wizard instead of the app. Pick your language and click Continue.

  4. Pass the requirements check

    The wizard checks your server. Green ticks mean you're good. For anything red, it shows exactly what to change (and your host can apply it). Click Recheck, then continue.

  5. Activate your license

    Paste your purchase / license code and continue. (Behind a firewall? Use Activate offline and follow the on-screen instructions.)

  6. Connect the database

    Enter the database name, username and password from Step 1. The wizard tests the connection and then sets everything up — you'll see a short progress bar.

  7. Create your admin account & company

    Enter your name, email and a password for the main administrator, then your company name, country, currency, time zone and industry (Retail, Pharmacy or Supermarket). This also creates your first store.

  8. Choose demo data (optional) & finish

    Decide whether to load sample products and sales so you can explore — or start empty. Click finish, and you'll land on the login page, ready to go.

The installer wizard showing the requirements check step
The installer wizard walks you through each step with clear ticks and crosses.

Pick the right industry

During setup you choose a primary industry. It tailors the system (and the optional demo data) to how your shop works:

IndustryWhat you get
RetailA general catalog with variants — clothing, electronics, general goods.
PharmacyMedicine catalog with batches & expiry and drug schedules.
SupermarketLarge catalog with weighed items and scale barcodes.

After installing

Once you're in, a few minutes in these areas gets you selling:

Tips & best practices

  • Use a fresh, empty database. Installing into a database that already has tables can cause conflicts.
  • Pick PHP 8.2 or newer first. If the requirements check flags the PHP version, switch it in your hosting panel before continuing.
  • Install on a real domain with HTTPS if you can — card payments and some features prefer a secure address.
  • Keep your purchase code safe. You'll need it for activation and for support.

Notes & warnings

The installer locks itself after setup. Once finished, the wizard won't run again (for security). To reinstall from scratch you'd remove the install lock and start over — only do this on a fresh, empty database.

One install = one company. The POS runs your business on its own server; it isn't a shared multi-company service. Multiple shops are handled as stores within the one install.

Stuck during install? Each wizard step explains any error and how to fix it. If you're still stuck, the Troubleshooting page covers the most common hosting hiccups.


Next: Getting started · Related: Settings · Updates & license · Backup & restore