This guide is only for migrating CodeIgniter to Laravel (or upgrading to 11.0v). Follow it only if you are moving from the CodeIgniter-based version to the new Laravel-based application.

Local requirements

For local installation or migration you need PHP 8.2. Install and use PHP 8.2 before running the migration or installer.

Supported upgrade path

You must be on OFF POS 10.9 to switch to OFF POS 11.0 or the Laravel version. If your running version is not 10.9, you cannot migrate to the Laravel version or 11.0v.

Update in same URL

Update will work only on the same URL. If you want to update on a different URL, the update will not work. For example: if your application is installed at `https://abc.com` and you want to update to `https://xyz.com`, the update will not work.

Important

If you try to migrate less than 10.9 to 11.0v, you may lose your data. The author is not responsible for any data loss if you do not follow this guide.

## Before you start — Backup your data

Create a backup of your database and configuration:

1. Export your database (e.g. via phpMyAdmin).
2. Zip your `Current Software` and keep it safe.
3. Backup your database `Username`, `Password`, `Database Name` from `application/config/database.php` from your existing software.
   Use these credentials in the Updater Installer database step.
   Use the existing database credentials here.

## Update steps

Step 1: Download the latest version from Code Canyon. Extract it in the root directory.

1. If your current software is at `https://abc.com`, the root directory will be:
   `app`
   `bootstrap`
   `config`
   `database`
   `public`
   `resources`
   `routes`
   `storage`
   `vendor`
   `vite.config.js`
   etc.
2. Update steps (installer) Hit the base url on browser: eg: https://retail-pos.com, you should hit your installation url.
   Step 1 — Click `Next`.
   Make sure all requirements are satisfied.
   Verify the purchase: enter your Envato username and purchase code.
   Important: Check “Already Installed Get Update”.
   Enter your database username, password, and database name from `application/config/database.php`. Leave database host and port blank unless different. Click `Next` to complete the update.

Done?

After the update completes, use your existing software credentials to log in.

## Tax configuration

After the update, configure tax: log in, go to `Settings` → `All Setting` → `Tax Setting` tab, then click `Migrate Tax Setting` to migrate tax.

Tax migration — click Migrate Tax Setting.

## Item image configuration

From your full software backup, go to `uploads/items` and copy those images into the new version at `public/uploads/items`.

Upload or move images exiting to new installed software location `public/uploads/items`.

## Other guide

- Upload the logo, favicon, and invoice logo again.
- Update your PWA (Progressive Web App) image to 512px × 512px.
- Assign permissions to user roles again.