Install purdm from source

If you have your server setup. You can just download purdm source files and get everything setup.

Requirements

You server must be installed.

Installation

You can download the latest release from the repo. Currently version 0.0.3

or you can use this https://wfspace.sfo2.digitaloceanspaces.com/wfexpenses0.0.3-dist.tar.gz

There should also be and updated version of the repo in this location. The last location will change it <wfexpenses0.0.4-dist.gar.gz> depending on the version number of purdm.

Login to your server and head to you web directory. Run the following command.

sudo wget https://wfspace.sfo2.digitaloceanspaces.com/wfexpenses0.0.3-dist.tar.gz

This will download the folder. Next we extract it

sudo tar -xvf wfexpenses0.0.3-dist.tar.gz

Now if you like you can copy the contents to your source directory. This is optional based on which folder you are currently in.

sudo cp -r wfexpenses0.0.3-dist/* html

The above command copies everything from you wfexpenses folder to the html directory.

Grant permission

You need to grant writeable permission to the assets and protected/runtime directories.

sudo chmod -R 0777 assets
sudo chmod -R 077 /protected/runtime

If you don't do this you will get an error.

Now head to your base url and see if the application works. You should be taken to the setup if everything works well.

Server configurations

For you web application to work properly you have two more steps to do. You need to turn on mod rewrite for apache.

sudo a2enmod rewrite

Then in your virtual host configuration usually found at /etc/apache2/sites-available/000-default.conf add the following lines to your directory path.

RewriteEngine on
RewriteRule ^index.php/ - [L,R=404]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php

Restart the server

sudo service apache2 restart

You application should be accessible now.

Setup

You should be taken to the setup page. Once you have no errors.

This page requires you database name etc.

You need to create a database and give purdm the user and password to continue. Once you do this click next.

Creating an admin user

You will now be taken to a screen to prompt you to create an admin user.

DONT SKIP THIS STEP

If you skip this step you will have to create an user from the command line.

Enter the required fields and click save credentials.

You will be taking to a success screen.

You can now login using the credentials you created.

Creating an account

Once you login the first thing you should do is create an account. On the left menu click the accounts dropdown and choose create an account.

Enter your account name and a starting balance.

Congrats. You can officially start using purdm.