Installing ultimatePOS

UltimatePOS

  1. Home
  2. Docs
  3. UltimatePOS
  4. Getting Started
  5. Installing ultimatePOS

Installing ultimatePOS

Installing UltimatePOS Advance & Lite

Server requirements

Make sure your server meets the following requirements:

  1. PHP >= 7.1 (Recommended: PHP version 7.2)
  2. OpenSSL PHP Extension
  3. PDO PHP Extension
  4. Mbstring PHP Extension
  5. Tokenizer PHP Extension
  6. XML PHP Extension
  7. cURL PHP Extension
  8. Zip PHP Extension
  9. GD PHP Extension

Server Recommendation

  • Ultimate POS can be installed in Localhost.
  • If you want to make it accessible online- We recommend using Cloud host – as it provides better flexibility or control of the server. You can use AWS or Digital Ocean or search for some others. Our demo site is set up on Digital Ocean.
  • You can also use Shared hosting. Like for example BigRocks, NameCheap, GoDaddy etc.

STEPS TO INSTALLING POS SYSTEM

  1. After downloading, extract the file onto your desktop using a zip software (like winzip or winrar or something else ) as shown below.

    Extract using WinZip

  2. In case you want to install the system locally, here are the steps:
    • 2.1 Download & Install a server like WAMP(for Windows) or XAMP(for windows or Linux) or something else as per your preference.
    • 2.2 Go to the htdocs folder.  htdocs folder is commonly present inside the xamp/htdocs.
    • 2.3 Copy the codebase folder (For example UltimatePOS-CodeBase-V2.8.1) present inside the unzipped file in step 1.
    • 2.4 Rename the folder to UltimatePOS. (For example: UltimatePOS-CodeBase-V2.8.1 to UltimatePOS)
    • 2.5 Now open http://localhost/UltimatePOS/install or http://localhost/UltimatePOS/public/install
      Here you will see a screen with “Doing some pre-installation checkup…”
    • 2.6 Make sure all checks are shows as Green-Tick. If there is something with Red-Cross then fix it and refresh the page to check again. After all Green-Tick click on “Go to Next Step”
    • 2.7 Follow the installation instructions as displayed in the screen.
    • 2.8 After all installation is done, Go inside public folder and delete the install folder present.
  3. In case you want to install the system in hosting, here are the steps:
    • 3.0 Make sure the URL of application is like www.yourwebsite.com or any-subdomain.yourwebsite.com  for better experience. Installing in folders like www.yourwebsite.com/any-folder-name/pos is not recommended.
    • 3.1 Upload the extracted POS zip file (all files & folders inside UltimatePOS-CodeBase-V2.8.1) in the server document root.
      • To upload the file you can use FTP client like filezilla (https://filezilla-project.org/)
      • Or you can upload it directly by logging into your cPanel (or direct admin) & going to file manager.
    • 3.3 Open your website http://your-pos-website.com/install or http://your-pos-website.com/public/install
    • 3.4 Make sure all shows a Green-Tick. If there is something with Red-Cross then fix it and refresh the page to check again. After all Green-Tick click on “Go to Next Step”
    • 3.5 Follow the installation instructions as displayed in screen.
    • 3.6 You will see the installation page as given below or if shows some error then check debugging errors notes given below.
    • 3.7 After all installation is done, Go inside public folder and delete the install folder present.
  4. “Doing some pre-installation checkup.” Screen: Make sure all are marked with Green-Tick  then click on “Next Step”

  5. POS installation screen:

    POS Installation Screen

    Read the instructions. it says to keep all your information ready for next step, like database details, email configuration, envato purchase code .

  6. Click on next “Let’s Go”. It will check your server. If all of them are green then you’re ready for next step, else install the php library missing. After everything looks correct it will show a green sign.
  7. Fill this form with all details & click on “Install”

    Details-ultimatePOS

  8. After clicking on “Install” if all details are correct it will go to the next step. If it shows invalid purchase code then refer to this guide.

    Env file details (if its shows “you must enter the file name”   the refer the “creating a hidden file in windows” guide below)

  9. Click on “Install” after this and wait for a few minutes to process (1 to 10 minutes depends on hosting)
  10. It will display an install success screen.

Debugging Errors:

While installation there can be some errors because of a few reasons, check the below & fix accordingly.

  1. Syntax Error: If it shows syntax error then make sure you have PHP version 7.0 or higher. It will be nice to have the latest PHP 7.2 version.
  2. 500 Internal Server error: This can happen if the server is not configured properly. Check your server Log and fix accordingly.
    1. If it shows SoftException in Application.cpp:651: Directory “/installed-directory/public” is writeable by group, referer: http://your-pos-website.com, then go to the public folder and make its permission as 755
    2. If it shows SoftException in Application.cpp:651: Directory “/installed-directory/public/index.php” is writeable by group, referer: http://your-pos-website.com, then go to the public/index.php folder and make its permission as 755
  3. Image not showing: Check this document to fix image issue: https://ultimatefosters.com/ultimate-pos/ultimatepos-faqs/#Logo_or_Image_not_Getting_displayed

Note:

  • You can create as many businesses as you want with this.
  • After successful installation, if you visit <your-awesome-domain>.com/install, you will get an error page. If you want to change any further details like the database, database name, host, database password; you can do it by changing in .env file present inside codebase.

Creating a hidden file in windows

In windows when you try to create .env file  – “You must type a file name” error is thrown.

In the File Explorer, call your file .env. and it will remove the ending ‘.’

Was this article helpful to you? Yes 1 No 2
🤔🤔 Got an Idea for UltimatePOS - Advance?✍ Share Idea
+ +