If you have already been using previous versions of stockawesome please jump to the Upgrade section.

Installation for Non-Developers/Production

This assumes you have already installed wamp and have your webserver up and running. Stockawesome is built to be simple and easy to use/install and it should take you less than 15 mins to set it up.

Server Requirements

The Laravel framework has a few system requirements:

  • PHP >= 5.4
  • Mcrypt PHP Extension
  • OpenSSL PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension
  • Enable PHP SNMP for both CLI and CGI

As of PHP 5.5, some OS distributions may require you to manually install the PHP JSON extension. When using Ubuntu, this can be done via apt-get install php5-json.


Laravel may require some permissions to be configured: folders within storage and vendor require write access by the web server.

Stockawesome Installation

Download Zip file and extract. The zip files will have the following files

  • Application
  • demodata
  • documentation
  • licenses
  • Licensing

In the Application folder copy and paste the stockawesome folder to your web directory server (in wamp this might be c:\wamp\www)

Enable rewrite_module on your webserver

Enable rewrite_module on your apache server. This is important routing will not work if this is not setup.

StockAwesome ships with a .htaccess file that is used to allow URLs without index.php. If you use Apache to serve your Laravel application, be sure to enable the mod_rewrite module.

For wamp you can watch this video to learn how to do it https://www.youtube.com/watch?v=DYACNC_RhF0


On Nginx, the following directive in your site configuration will allow "pretty" URLs:

location / {
    try_files $uri $uri/ /index.php?$query_string;

Install database

You need to create new database names stockawesome , you can use phpmyadmin or any mysql databse tools such maestro , sqlyog etc

My helpful screenshot

After new database created import the database files from Application/database/stockawesome.sql folder.

My helpful screenshot

making sure you are in the stockawesome database choose the sql file and click go.

My helpful screenshot

Finally in the application folder (stockawesome) go to application/.env and edit your database settings. The defaults are as shown below


Read the ENV File chapter on more .env settings.

If on linux/mac osx please give all files in folder read write permissions using chmod -R 777 * on the stockawesome folder only do this if when you visit the application you get a white blank page.

Congrats you are done visit your site at http://localhost/stockawesome default login:dwanyoike@codedcell.com password:test123

Enable SNMP

To enable SNMP in windows click wamp icon in taskbar, click PHP then PHP extenstions and then tick php_snmp.

My helpful screenshot

Then we need to enable snmp in cli since we get printer levels using cronjobs/scheduled tasks to do this

find out where your PHP CLI configuration is by running

where php

my output was


then edit the php.ini in the folder phpphp5.5.12 or whichever folder you got from the above command. Make sure the line


is uncommented


To test run the application first you can import the demodata/stockawesome.sql file located in your downloaded zip.

Setting up emailing

Setting up how to send email reports in Stock Awesome is pretty easy all you need to do is set the below in your .env file. this file is located at the root of your Stock awesome application in stockawesome/application/.env.

My helpful screenshot

My helpful screenshot


Set this to false to allow your application to start sending email messages. Otherwise you emails will be sent to your log files.


Stock Awesome supports both SMTP and PHP's "mail" function as drivers for the sending of e-mail. By default, Stock Awesome is setup for SMTP mail.

Supported: "smtp", "mail", "sendmail", "mailgun", "mandrill", "log"


Here you may provide the host address of the SMTP server used by Stock Awesome.


This is the SMTP port used by your application to deliver e-mails to users of the application.


You may wish for all e-mails sent by your application to be sent from the same address. Here, you may specify a name and address that is used globally for all e-mails that are sent by your application.


If your SMTP server requires a username for authentication, you shouldset it here. This will get used to authenticate with your server on connection.


Here you may set the password required by your SMTP server to send out messages from your application. This will be given to the server on connection so that the application will be able to send messages.