Help Center

Install onto Existing Server (Manual Install)

Chris Muench
Chris Muench
  • Updated

This is for new installs ONLY

If you are upgrading PHP POS from a previous version follow the instructions at Upgrading PHP Point Of Sale (Manual Install)

Below are the steps for installing PHP Point Of Sale manually onto your existing server.

 

Server Requirements

PHP Point Of Sale must be installed on a server that has the following software installed.

  • PHP 7.3-8.2
  • Mysql 5 or greater (5.6.4 or higher recommended)
  • GD 2 Library
  • php xml
  • php zip
  • SoapClient (if using Mercury/Vantiv credit card processing)

  • download the Manual/Source Install (.zip) version:

6b278e1-Screenshot_2017-04-28_09.28.47.png
 

Setup Database

Below are the instructions for creating a database and database user for the application. Most servers provided by hosting companies provide access to cPanel. If so you should follow the instructions for cPanel.

 

Servers with cPanel

  1. Login to cPanel and open MySQL Databases
e2faef7-Screenshot_2017-04-28_09.30.16.png

Open "mySQL Databases"

  1. Create a New Database and name it something similar to this:
f41fceb-Screenshot_2017-04-28_09.33.38.png

Create Database

  1. Scroll down to "Add New User" and Add a New User for the application to use:
0bba8de-Screenshot_2017-04-28_09.35.44.png

Add a New User

  1. Scroll further down and Add the User To the Database we just created:
70c0ff5-Screenshot_2017-04-28_09.36.13.png

Add User to Database

  1. Assign all privileges to the user for our new database:
aa18d05-Screenshot_2017-04-28_11.20.09.png
  1. download the .zip file from PHP POS Download Page

Enter your email address and a link to the following page should be sent to your email if you cannot find the original:

9d618df-Screenshot_2017-04-28_09.28.47.png
  1. Upload the zip file:
9f80a19-Screenshot_2017-04-28_09.39.05.png

Upload the .zip file

Once the upload is finished you should see this:

4297cea-Screenshot_2017-04-28_09.40.58.png

Upload finished, go back.

  1. Extract the file to your www root folder:
bb59414-Screenshot_2017-04-28_09.45.06.png

Extract the file to the public_html folder or "webroot"

  1. Rename the folder to "pos"
5ff44f3-Screenshot_2017-04-28_09.47.57.png
  1. Navigate to "application/config/database.php.tmpl" and change the name of the file to "database.php"
067df0f-Screenshot_2017-04-28_09.54.35.png

rename database.php.tmpl to database.php

  1. Open the Code Editor and edit database.php
a994bb8-Screenshot_2017-04-28_09.56.21.png

Edit database.php

12: Edit the following lines below the //comments

<?php
$active_group = "default";
$query_builder = TRUE;

//1. This should be your db server name; usually localhost or 127.0.0.1
$db['default']['hostname'] = 'localhost';
$db['default']['dsn'] = '';

// 2. Enter your database username you created
$db['default']['username'] = 'mike_phppos';

//3. Enter your database password you created
$db['default']['password'] = 'YOURPASSWORD';

//4. Enter your database name you created
$db['default']['database'] = 'mike_phppos';

$db['default']['dbdriver'] = 'mysqli';
$db['default']['dbprefix'] = 'phppos_';
$db['default']['pconnect'] = FALSE;
$db['default']['db_debug'] = FALSE;
$db['default']['cache_on'] = FALSE;
$db['default']['cachedir'] = '';
$db['default']['char_set'] = 'utf8';
$db['default']['dbcollat'] = 'utf8_general_ci';
?>

Click Save Changes

Save the changes we made!

1873f3b-Screenshot_2017-04-28_10.08.59.png
  1. Open your browser and enter the URL for your server. If you named the folder 'pos' you should see
    this after you click install:
811c780-Screenshot_2017-04-28_11.17.36.png

Inital installation complete, click on Login

  1. Installation is now complete!

Login with:

username: admin
password: pointofsale

make sure to change the password later!

499d9af-Screenshot_2017-04-28_11.18.28.png
 

Servers without cPanel

  1. Open phpMyadmin or mysql from the command line and create a new database. Type “pointofsale” in the "Create new database" field and click Create to create the database in phpMyAdmin. phpMyAdmin can often be accessed from your control panel form your hosting company.
a5bbbc0-phpMyAdminCreateDatabase.png

Creating a database in phpMyAdmin

  1. Once database has been created, a message will be displayed in the phpMyAdmin saying "Database pointofsale has been created" (as shown below)
b37bb29-phpMyAdminDatabaseCreated.png

Created a database

 

Upload & Configuring Code

  1. Configuring the database

    • To configure the database, go to "phppos/application/config" In this folder rename "database.php.tmpl” to "database.php" and open in a text editor.
  2. Scroll down to the bottom of the file where you see the below. Edit all lines in with comments below to match your database configuration. Do NOT change any other lines.

<?php
$active_group = "default";
$query_builder = TRUE;

//This should be your db server name; usually localhost
$db['default']['hostname'] = 'localhost';
$db['default']['dsn'] = '';

//This is your database username
$db['default']['username'] = 'root';

//This is your database password
$db['default']['password'] = '';
//This is your database name
$db['default']['database'] = 'pointofsale';

$db['default']['dbdriver'] = 'mysqli';
$db['default']['dbprefix'] = 'phppos_';
$db['default']['pconnect'] = FALSE;
$db['default']['db_debug'] = FALSE;
$db['default']['cache_on'] = FALSE;
$db['default']['cachedir'] = '';
$db['default']['char_set'] = 'utf8';
$db['default']['dbcollat'] = 'utf8_general_ci';
?>

Then save the "database.php" file. If it doesn’t allow saving, save it to desktop, then replace the file with the existing one.

After configuring the files, simply copy all the files to your web server!

 

Logging In

 

NOW YOU ARE DONE!

  1. point your browser to http://yourserver.com/PATH/TO/PHPPOS and follow the on screen steps

  2. The default username is "admin" and the default password is "pointofsale"

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.