How to Install Updated Customized Magestore POS via SSH

Customized Magestore POS Package is the customer environment-specific package, it contains the Original POS Package that you are purchased and all customized works that we have done for you (including bug fixing, new features, integration with 3rd extension).


This guide applies to install the updated version of Customized Magestore POS on your website (the major, minor, or the patch update of your current installed Magestore POS). In case that you want to migrate from the old Magestore POS system or upgrade across lines of POS, please contact with Magestore Support Team to get a suitable guideline.

If you are looking for the guide to install a brand new Customized Magestore POS, it’s here.

Compatibility Check

Please check the link below to make sure that the POS version you are having is compatible with your current Magento version.


Magestore POS Line 4 (POS Pro 4, POS Pro Commerce 4, POS Enterprise 4, POS Enterprise Commerce 4) requires MSI to be installed and enabled before installing the POS. You can follow the guide Install Inventory Management from Magento to install and enable MSI.

Update the POS

1. Take a backup of your website

The backup will help you recover faster in case that you are failed while updating Magestore POS due to some conflict with other extensions or unexpected incidents.

2. Turn on Maintenance

php bin/magento maintenance:enable

3. Turn off Magento Cron

php bin/magento cron:remove

4. Turn on Developer mode

php bin/magento deploy:mode:set developer

5. Terminate the magestore_pos_process_order

This is a very important step: kill consumers will prevent caching code in the started consumer

Only applied for

  • POS Enterprise Commerce >= v4.8.0

  • POS Enterprise >= v4.13.8

  • POS Pro Commerce >= v4.5.0

  • POS Pro >= v4.15.0

pgrep -f 'magestore_pos_process_order' | xargs kill -9

6. Upload the package to Magento Root Directory

7. Extract the package and copy it to Magento Root Directory

We always distribute the full package to keep the consistency, the full package means it includes all earlier releases of the current package that you are having.

cd <magento_root_directory> rm -rf app/code/Magestore tar -xf <package_name>

8. Run upgrade command (Update POS)

php bin/magento setup:upgrade

9. Deploy POS client

This is a very important step: If you don’t run this command, you can’t access the POS application

php bin/magento webpos:deploy

10. Run code compilation

php bin/magento setup:di:compile

11. Install Magento Cron

php bin/magento cron:install

12. Reindex All

php bin/magento indexer:reindex

13. Turn on Production mode

php bin/magento deploy:mode:set production

14. Turn off Maintenance

php bin/magento maintenance:disable


You can use the below script for automating the update process.

Make sure that you change the <magento_root_directory> and <package_name> with the suitable value cause it is the variable.

cd <magento_root_directory> php bin/magento maintenance:enable php bin/magento cron:remove php bin/magento deploy:mode:set developer pgrep -f 'magestore_pos_process_order' | xargs kill -9 rm -rf app/code/Magestore tar -xf <package_name> php bin/magento setup:upgrade php bin/magento webpos:deploy php bin/magento setup:di:compile php bin/magento cron:install php bin/magento indexer:reindex php bin/magento deploy:mode:set production php bin/magento maintenance:disable