Home

Tour

Guide

Tips

Industries

Articles

ContactUs

Installation

ThisinstallationguidecoversinstallingOSPOSonWindowsusingWampServer.Youshouldalsobeabletousethis
guidetohelpyouinstallthesystemonanywebserver.
ThisguidehasbeentestedwithOSPOS2.3.1.Ignoreanyimagesthatmentionanotherversion.Wejustdidn'tbother
updatingthem.
Feelfreetocontactus(/contact)ifthere'sanewerversionreleasedandwedon'tmentionitonthispage.Wewantto
trytomakesurethisinstallationguideisalwaysuptodate.
WhenyoudownloadOSPOS(http://sourceforge.net/projects/opensourcepos/),youshouldfindafilecalled
README.md.Thisincludesinformationabouthowtoinstalltheapplication.
Unfortunately,thesestepscanbeconfusingforpeoplenotusedtoinstallingwebapplications.Sowe'vewrittenthis
guidetohelpouttheOSPOScommunity.Notethatwe'vechangedtheorderofsomeofthestepstomakethe
installationprocesseasier.
We'vealsoassumedthatyouknowbasicWindowsadministration,suchasunzippingfilesandcopyingfilesinto
directories.
HowtoInstall
1.Create/locateanewMySQLdatabasetoinstallOpenSourcePointofSaleinto
Todothis,youactuallyhavetwooptions:youcaninstallOSPOSonyourlocalcomputeroryoucaninstallitontheWeb.
Forthisguide,we'regoingtoassumeyou'reinstallingitonyourlocalWindowsmachine.
StartbydownloadingandinstallingWampServer(http://www.wampserver.com/en/).You'llneedthissoftwaretorun
OSPOS.
(Note:ifWampServercrashesafteryouinstallitandsayssomethingaboutAestanTrayMenu,install.NETFramework
3.5.Thatfixedtheproblemforus.)
WhenWampServer'sinstalled,lookinyourtaskbarforaGreenW.Clickthaticon,andlookforphpMyAdmin.Clickthat,
andtheprogramshouldlaunch.
YoushouldfindyourselfinsidephpMyAdmin.ClickontheDatabasestabtogettothe"CreateNewDatabase"form.
FilloutanameandclicktheCreatebutton.Itshouldlooklikethescreenshotbelow:

YoushouldnowseeyournewdatabaseintheDatabaseslist.Clickonyournewdatabase.Itshouldlooksomethinglike
this:

Nowthatyou'veloadedupyournewdatabase,it'stimetoaddauser.
ClickonthePrivilegestabandthenonthe"AddUser"link.
(Note:Ifyoudon'tseethePrivilegestab,lookforitundertheMoretab.)
Filloutthe"AddUser"form.
The"LoginInformation"shouldlooklikethescreenshotbelow:

Obviously,youcanuseanyusernameandpasswordthatyouwant.Wealwaysautomaticallygenerateapasswordwith
phpMyAdmin,becauseit'smoresecure.
Now,beforeyoudoanythingelse,openupNotepad(Startmenu>AllPrograms>Accessories>Notepad)andcopy
theUsername,password,anddatabasenameintoit.You'llneedthisinformationinafewminutes.
Whenyou'vedonethat,scrolldowntothebottomofthepageinphpMyAdminandclickthe"Adduser"buttoninthe
bottomrighthandcorner.Youcanleavetherestofthesettingsastheyare.You'venowcreatedauserforyour
database.
2.UnzipanduploadtheOpenSourcePointofSalefilestowebserver
DownloadthelatestversionofOSPOSifyouhaven'talready.Youcandownloaditfromsourceforge

(http://sourceforge.net/projects/opensourcepos/).Justclickthebig,greenbutton.Itshouldlooklikethescreenshot
below:

Whenyoudownloadthatfile,you'llwanttounziptheOSPOSfilesintoyourWampServerwebdirectory.
Bydefault,thisdirectoryis"C:\wamp\www".So,unlessyou'vechangedthis,unziptheOSPOSfilesthere.Thefilesare
storedinadirectorycalled"opensourceposmaster".Renamethistoopensourcepos.
3.Executethefiledatabase/database.sqltocreatethetablesneeded
Nowthatyou'vecreatedadatabaseandauser,andunzippedtheOSPOSfiles,you'llneedtoaddsomedatatoyour
databasesothatOpenSourcePointofSalewillwork.
Makesureyou'reinsidethedatabaseyoumade.Thenclickonthe"Import"tabinphpMyAdmin.Itwilllooklikethe
screenshotbelow:

You'llgettoascreencalled"Importingintothedatabase...".Lookunderthe"Filetoimport"headingforthe"Choose
File"button.Clickthat,andbrowseto"C:\wamp\www\opensourcepos\database"anddoubleclickonthe"database.sql"
file.Lookforthe"Go"buttonatthebottomofthepage,andclickit.Youcanleavetherestofthesettingsastheyare.
Whenit'sdoneimportingthefile,youshouldseeagreensuccessmessagethatlookslikethescreenshotbelow:

ThismeansthatthetablesanddatayouneedtouseOSPOShavebeencreated.
46.ModifyOSPOSconfigurationfiles
Browseto"C:\wamp\www\opensourcepos\application\config"andlookforafilecalled"database.php.tmpl".Rename
thisfile"database.php"andthenopenitsoyoucaneditit.
(Note:ifyouneedagoodtexteditor,tryNotepad++(http://notepadplusplus.org/).)
You'llwanttochangelines5254.
52:$db['default']['username']='yourusername'
53:$db['default']['password']='yourpassword'
54:$db['default']['database']='yourdatabase'
Copyyourusername,password,anddatabasefromthetextfileyoucreatedearliertotheconfigurationfile.Replace
yourusername,yourpassword,andyourdatabasewithyouractualusername,password,anddatabasefromthetext
file.Makesureyoupastethembetweenthesinglequotes.
ModifyingtheselineswilltellOSPOStousethedatabaseanduseryoucreatedearlier.
Savethisfile,andthenopen"config.php"andlookonline240.Changethislinetoauniqueencryptionkey.

Feelfreetousetherandomkeygeneratedbythisencryptionkeygenerator(http://jeffreybarke.net/tools/codeigniter
encryptionkeygenerator/).
You'renowdoneeditingtheconfigurationfiles.It'stimetoruntheapplicationforthefirsttime.
7.GotoyourPointofSaleinstallviathebrowser
YoucanreachyourOSPOSinstallviaawebbrowser.We'vefoundGoogleChrome(http://www.google.com/chrome)
worksthebestwithOSPOS.
Browseto"http://localhost/opensourcepos/"andyoushouldseetheOSPOSloginform.Itshouldlooklikethe
screenshotbelow:

8.LOGINusingdefaultusernameandpassword
Thedefaultlogininformationis:
Username:admin
Password:pointofsale
TypetheseintotheLoginForm,andclicktheGobutton.
(Note:ifyougetanerrormessage"Unabletoloadtherequestedlanguagefile:
language/english/form_validation_lang.php"gotoapplication/config/config.phpandchangeline85from'english'to
'en'.)
Ifyou'veinstalledOSPOScorrectly,youshouldseethewelcomescreen:

Note:ifyouwantOpenSourcePointofSaletolookmorelikeanapplication,insteadofawebsite,pleasereadourtip
(/tips/makeosposrunapplication)aboutGoogleChromeapplicationshortcuts.