Home Tour Guide Tips Industries Articles Contact 

Us

Installation

This installation guide covers installing OSPOS on Windows using WampServer.  You should also be able to use this
guide to help you install the system on any web server. 

This guide has been tested with OSPOS 2.3.1. Ignore any images that mention another version.  We just didn't bother
updating them.

Feel free to contact us (/contact) if there's a newer version released and we don't mention it on this page.  We want to
try to make sure this installation guide is always up to date.

When you download OSPOS (http://sourceforge.net/projects/opensourcepos/), you should find a file called
README.md.  This includes information about how to install the application.

Unfortunately, these steps can be confusing for people not used to installing web applications.  So we've written this
guide to help out the OSPOS community.  Note that we've changed the order of some of the steps to make the
installation process easier.

We've also assumed that you know basic Windows administration, such as unzipping files and copying files into
directories. 

How to Install

1. Create/locate a new MySQL database to install Open Source Point of Sale into

To do this, you actually have two options: you can install OSPOS on your local computer or you can install it on the Web.

For this guide, we're going to assume you're installing it on your local Windows machine.

Start by downloading and installing WampServer (http://www.wampserver.com/en/).  You'll need this software to run
OSPOS.

(Note: if WampServer crashes after you install it and says something about Aestan Tray Menu, install .NET Framework
3.5.  That fixed the problem for us.)

When WampServer's installed, look in your taskbar for a Green W.  Click that icon, and look for phpMyAdmin.  Click that,
and the program should launch.

You should find yourself inside phpMyAdmin.  Click on the Databases tab to get to the "Create New Database" form.

Fill out a name and click the Create button.  It should look like the screenshot below:
You should now see your new database in the Databases list.  Click on your new database.  It should look something like
this:

Now that you've loaded up your new database, it's time to add a user.

Click on the Privileges tab and then on the "Add User" link.

(Note: If you don't see the Privileges tab, look for it under the More tab.)

Fill out the "Add User" form.

The "Login Information" should look like the screenshot below:

Obviously, you can use any user name and password that you want.  We always automatically generate a password with
phpMyAdmin, because it's more secure.

Now, before you do anything else, open up Notepad (Start menu ­> All Programs ­> Accessories ­> Notepad) and copy
the User name, password, and database name into it.  You'll need this information in a few minutes.

When you've done that, scroll down to the bottom of the page in phpMyAdmin and click the "Add user" button in the
bottom right hand corner.  You can leave the rest of the settings as they are.  You've now created a user for your
database.

2. Unzip and upload the Open Source Point of Sale files to web server

Download the latest version of OSPOS if you haven't already.  You can download it from sourceforge
(http://sourceforge.net/projects/opensourcepos/).  Just click the big, green button.  It should look like the screenshot
below:

When you download that file, you'll want to unzip the OSPOS files into your WampServer web directory.

By default, this directory is "C:\wamp\www".  So, unless you've changed this, unzip the OSPOS files there.  The files are
stored in a directory called "opensourcepos­master".  Rename this to opensourcepos.

3. Execute the file database/database.sql to create the tables needed

Now that you've created a database and a user, and unzipped the OSPOS files, you'll need to add some data to your
database so that Open Source Point of Sale will work.

Make sure you're inside the database you made.  Then click on the "Import" tab in phpMyAdmin.  It will look like the
screenshot below:

You'll get to a screen called "Importing into the database...".  Look under the "File to import" heading for the "Choose
File" button.  Click that, and browse to "C:\wamp\www\opensourcepos\database" and double­click on the "database.sql"
file.  Look for the "Go" button at the bottom of the page, and click it.  You can leave the rest of the settings as they are.

When it's done importing the file, you should see a green success message that looks like the screenshot below:

This means that the tables and data you need to use OSPOS have been created.

4­6. Modify OSPOS configuration files

Browse to  "C:\wamp\www\opensourcepos\application\config" and look for a file called "database.php.tmpl".  Rename
this file "database.php" and then open it so you can edit it.

(Note: if you need a good text editor, try Notepad++ (http://notepad­plus­plus.org/).)

You'll want to change lines 52­54.

52: $db['default']['username'] = 'yourusername';
53: $db['default']['password'] = 'yourpassword';
54: $db['default']['database'] = 'yourdatabase';

Copy your username, password, and database from the text file you created earlier to the configuration file. Replace
yourusername, yourpassword, and yourdatabase with your actual username, password, and database from the text
file.  Make sure you paste them between the single quotes.

Modifying these lines will tell OSPOS to use the database and user you created earlier.

Save this file, and then open "config.php" and look on line 240.  Change this line to a unique encryption key.
Feel free to use the random key generated by this encryption key generator (http://jeffreybarke.net/tools/codeigniter­
encryption­key­generator/).

You're now done editing the configuration files.  It's time to run the application for the first time.

7. Go to your Point of Sale install via the browser

You can reach your OSPOS install via a web browser.  We've found Google Chrome (http://www.google.com/chrome)
works the best with OSPOS.

Browse to "http://localhost/opensourcepos/" and you should see the OSPOS login form.  It should look like the
screenshot below:

8. LOGIN using default username and password

The default login information is:

Username: admin
Password: pointofsale

Type these into the Login Form, and click the Go button.

(Note: if you get an error message ­ "Unable to load the requested language file:
language/english/form_validation_lang.php" ­ go to application/config/config.php and change line 85 from 'english' to
'en'.)

If you've installed OSPOS correctly, you should see the welcome screen:
Note: if you want Open Source Point of Sale to look more like an application, instead of a website, please read our tip
(/tips/make­ospos­run­application) about Google Chrome application shortcuts.