allocPSA is the web-app that takes care of your projects, employees, time sheets, invoicing and customers.
allocPSA is generally intended to run with PHP>=5 and MySQL>=4 on a Linux server. It possibly runs on a Windows box, but is untested.
You will need to install php, mysql, and php-mbstring. The php-gd package is also recommended. On Debian, this will get all that is needed:
# apt-get install apache2 php php-mysql php-mbstring php-gd mariadb-server make python
Ensure mariadb is running in utf8 mode and not utf8mb4, see the config files for mariadb in /etc/.
To install allocPSA:
-
Put the allocPSA source code in a directory called e.g.
allocin your httpd servers document root. E.g.:/var/www/html/alloc/ -
Make the patches and css, e.g.:
$ make patches; make css
-
In a web browser, go to your servers hostname + directory where you put the alloc source code, such as:
http://localhost/alloc/ -
Follow the instructions in the web browser to complete the installation.
To determine which version you are currently running, look at the fine print at
the bottom of the login screen for allocPSA, or alternatively view the file:
http://YOUR_ALLOC_INSTALLATION/util/alloc_version
-
Backup your allocPSA database. DO IT NOW.
-
Unpack the new allocPSA source code alongside your current installation.
-
Copy the
alloc_config.phpfile from your current installation of allocPSA into the directory that contains the new installation of allocPSA. -
Finally, update your allocPSA database by going to this address in your web browser:
http://YOUR_NEW_ALLOC_INSTALLATION/installation/patch.phpApply each patch separately, starting from the top and working your way down. If you get errors stop the process and use the support forums.
We'd love your help, make an issue, write a pull request, start a discussion.
Also see doc/DEVELOPERS.md for an example development setup. 🙂
Please feel free to contact us at Cyber IT Solutions info@cyber.com.au or use the forums if you have any questions.
If you found a bug, please create an issue!
Email support@allocpsa.com for commercial and hosting enquiries.
allocPSA is under the GNU Affero General Public License. For more info please see the LICENSE file or visit the GNU Affero General Public License webpage.