Home Ho me
Tour To ur
Guid Gu ide e
Tips Ti ps
Indu In dust strrie ies s
Arti Ar ticl cle es
Con onta tact ct Us
Installation
This installation installation guide covers installing OSPOS on Windows usin g WampServer. 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 OSPOS 2.3.1. Ignore any images that mention another version. version. We just didn't bother updating them. Feel Feel free to contact us (/contact) (/contact) if there's a newer newer version released released and we don't mention it on on this page. We want to try to make make sure this installation guide is always up to date. When When you download OSPOS (http://sourceforge.net/projects/opensourcepos/), (http://sourceforge.net/projects/opensourcepos/) , you should find a file called README.md README.md.. This includes information about about how to install the application. Unf ortunately, ortunately, these steps can be confusing confusing for people not used to installing web applications. So we've written this guide guide to help help out the OSPOS community. Note that we've changed the order of some of of the steps to make the installation installation process easier. We've We've also assumed that you know basic Windows administration, such as unzipping files and copying files into direc 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/). (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 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. phpMyAdmin. Click on the Databases tab to get to the "Create New Database" form. Fill out a name and click the Create button. button. It should look like the screenshot 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/codeigniterencryption-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.