Installation

ThisinstallationguidecoversinstallingOSPOSonWindowsusingWampServer.Youshouldalsobeabletousethisguidetohelpyouinstallthesystemonanywebserver.

ThisguidehasbeentestedwithOSPOS2.3.1.Ignoreanyimagesthatmentionanotherversion.Wejustdidn'tbotherupdatingthem.

Feelfreetocontactus(/contact)ifthere'sanewerversionreleasedandwedon'tmentionitonthispage.Wewanttotrytomakesurethisinstallationguideisalwaysuptodate.

WhenyoudownloadOSPOS(http://sourceforge.net/projects/opensourcepos/),youshouldfindafilecalledREADME.md.Thisincludesinformationabouthowtoinstalltheapplication.

Unfortunately,thesestepscanbeconfusingforpeoplenotusedtoinstallingwebapplications.Sowe'vewrittenthisguidetohelpouttheOSPOScommunity.Notethatwe'vechangedtheorderofsomeofthestepstomaketheinstallationprocesseasier.

We'vealsoassumedthatyouknowbasicWindowsadministration,suchasunzippingfilesandcopyingfilesintodirectories.

HowtoInstall

1.Create/locateanewMySQLdatabasetoinstallOpenSourcePointofSaleinto

Todothis,youactuallyhavetwooptions:youcaninstallOSPOSonyourlocalcomputeroryoucaninstallitontheWeb.

Forthisguide,we'regoingtoassumeyou'reinstallingitonyourlocalWindowsmachine.

StartbydownloadingandinstallingWampServer(http://www.wampserver.com/en/).You'llneedthissoftwaretorunOSPOS.

(Note:ifWampServercrashesafteryouinstallitandsayssomethingaboutAestanTrayMenu,install.NETFramework3.5.Thatfixedtheproblemforus.)

WhenWampServer'sinstalled,lookinyourtaskbarforaGreenW.Clickthaticon,andlookforphpMyAdmin.Clickthat,andtheprogramshouldlaunch.

YoushouldfindyourselfinsidephpMyAdmin.ClickontheDatabasestabtogettothe"CreateNewDatabase"form.

FilloutanameandclicktheCreatebutton.Itshouldlooklikethescreenshotbelow:

Home Tour Guide Tips Industries Articles ContactUs

YoushouldnowseeyournewdatabaseintheDatabaseslist.Clickonyournewdatabase.Itshouldlooksomethinglikethis:

Nowthatyou'veloadedupyournewdatabase,it'stimetoaddauser.

ClickonthePrivilegestabandthenonthe"AddUser"link.

(Note:Ifyoudon'tseethePrivilegestab,lookforitundertheMoretab.)

Filloutthe"AddUser"form.

The"LoginInformation"shouldlooklikethescreenshotbelow:

Obviously,youcanuseanyusernameandpasswordthatyouwant.WealwaysautomaticallygenerateapasswordwithphpMyAdmin,becauseit'smoresecure.

Now,beforeyoudoanythingelse,openupNotepad(Startmenu>AllPrograms>Accessories>Notepad)andcopytheUsername,password,anddatabasenameintoit.You'llneedthisinformationinafewminutes.

Whenyou'vedonethat,scrolldowntothebottomofthepageinphpMyAdminandclickthe"Adduser"buttoninthebottomrighthandcorner.Youcanleavetherestofthesettingsastheyare.You'venowcreatedauserforyourdatabase.

2.UnzipanduploadtheOpenSourcePointofSalefilestowebserver

DownloadthelatestversionofOSPOSifyouhaven'talready.Youcandownloaditfromsourceforge

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

Whenyoudownloadthatfile,you'llwanttounziptheOSPOSfilesintoyourWampServerwebdirectory.

Bydefault,thisdirectoryis"C:\wamp\www".So,unlessyou'vechangedthis,unziptheOSPOSfilesthere.Thefilesarestoredinadirectorycalled"opensourceposmaster".Renamethistoopensourcepos.

3.Executethefiledatabase/database.sqltocreatethetablesneeded

Nowthatyou'vecreatedadatabaseandauser,andunzippedtheOSPOSfiles,you'llneedtoaddsomedatatoyourdatabasesothatOpenSourcePointofSalewillwork.

Makesureyou'reinsidethedatabaseyoumade.Thenclickonthe"Import"tabinphpMyAdmin.Itwilllooklikethescreenshotbelow:

You'llgettoascreencalled"Importingintothedatabase...".Lookunderthe"Filetoimport"headingforthe"ChooseFile"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".Renamethisfile"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.Replaceyourusername,yourpassword,andyourdatabasewithyouractualusername,password,anddatabasefromthetextfile.Makesureyoupastethembetweenthesinglequotes.

ModifyingtheselineswilltellOSPOStousethedatabaseanduseryoucreatedearlier.

Savethisfile,andthenopen"config.php"andlookonline240.Changethislinetoauniqueencryptionkey.

Feelfreetousetherandomkeygeneratedbythisencryptionkeygenerator(http://jeffreybarke.net/tools/codeigniterencryptionkeygenerator/).

You'renowdoneeditingtheconfigurationfiles.It'stimetoruntheapplicationforthefirsttime.

7.GotoyourPointofSaleinstallviathebrowser

YoucanreachyourOSPOSinstallviaawebbrowser.We'vefoundGoogleChrome(http://www.google.com/chrome)worksthebestwithOSPOS.

Browseto"http://localhost/opensourcepos/"andyoushouldseetheOSPOSloginform.Itshouldlooklikethescreenshotbelow:

8.LOGINusingdefaultusernameandpassword

Thedefaultlogininformationis:

Username:adminPassword: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.