WallacePOS is EOL. It is no longer being maintained by micwallace/wallacepos.

It is not currently recommended to deploy WallacePOS in a production evniroment

Instalation Prerequisites

A Lamp/Wamp server with PHP version>=5.4, Apache version>=2.4.7 with the following moudles enabled

```

proxy_http
proxy_wstunnel
rewrite
php5-curl
php5-gd

```

if you are using HTTPS add the following virtual host snippet in your apache config, replace %*% with your values and modify to your needs. You can skip this step but using plain http is not reccomened.

```
    <VirtualHost *:443>
         DocumentRoot %/your_install_dir%
         ServerName %your.server.fqdn%

         ErrorLog ${APACHE_LOG_DIR}/error.log
         CustomLog ${APACHE_LOG_DIR}/access.log combined

         SSLEngine on
             SSLCipherSuite !ADH:!DSS:!RC4:HIGH:+3DES:+RC4
             SSLProtocol all -SSLv2 -SSLv3
             SSLCertificateFile %certificate_location%
             SSLCertificateKeyFile %key_location%
             SSLCertificateChainFile %cert_chain_location%

         <Directory %/your_install_dir%>
            AllowOverride all
         </Directory>

         # WSPROXY CONF
         ProxyRequests Off
         ProxyPreserveHost On
         <Proxy *>
                 Order deny,allow
                 Allow from all
         </Proxy>
         RewriteEngine On
         RewriteCond %{HTTP:Connection} Upgrade [NC]
         RewriteRule /(.*) ws://localhost:8080/$1 [P,L]
         ProxyPass        /socket.io http://localhost:8080/socket.io/
         ProxyPassReverse /socket.io http://localhost:8080/socket.io/
         <Location /socket.io>
                 Order allow,deny
                 Allow from all
         </Location>
    </VirtualHost>
```

Installation & Startup

1. Clone the latest WallacePOS release to your Apache document root directory (htdocs) (public) (public_html)

2. In terminal run composer install and npm i in your install directory to update PHP dependencies (you may need to install composer and npm first).

3. Create a mysql database

4. In terminal navigate to your install directory then cd /api then node server.js

you should see socket.io - Started

5. Visit /installer in your browser & follow the installation wizard.

6. Login to the admin dashboard at /admin, from the menu go to Settings -> Utilities and make sure the feed server has been started successfully.