Skip to content
Aaron Riedener edited this page Jul 29, 2017 · 49 revisions

koalixcrm Installation

Support

There will be a list of local Support in your Country as soon as I get some information about that. Currently there is only one: Me of cause ;-) Visit my website: http://www.koalix.com to get more information about my services.

Requirements

django 1.11

django is an open source web application framework, written in Python, which follows the model-view-controller architectural pattern. It was originally developed to manage several news-oriented sites for The World Company of Lawrence, Kansas, and was released publicly under a BSD license in July 2005; the framework was named after gypsy jazz guitarist Django Reinhardt. In June 2008 it was announced that a newly formed Django Software Foundation will take care of Django in the future. http://www.djangoproject.com/

django-filebrowser-no-grappelli

Filebrowser, needed to serve the template files

apache fop

Formatting Objects Processor (FOP) is a Java application that converts XSL Formatting Objects (XSL-FO) files to PDF or other printable formats. FOP was originally developed by James Tauber who donated it to the Apache Software Foundation in 1999. It is part of the Apache XML Graphics project. http://xmlgraphics.apache.org/fop/

git

Git is a free & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency. Every Git clone is a full-fledged repository with complete history and full revision tracking capabilities, not dependent on network access or a central server. Branching and merging are fast and easy to do. http://git-scm.com/

step by step installation

First of all: I decided to not integrate or use external projects wherever possible.

ubuntu 17.04

sudo bash
apt-get install apache2 git fop libapache2-mod-wsgi postgresql
sudo su postgres
psql
ALTER USER postgres WITH PASSWORD 'youradminpasswordforpostgresql'; 
CREATE USER koalixcrm WITH PASSWORD 'passwordforkoalixcrmdatabase';
CREATE DATABASE koalixcrm ENCODING 'UTF8'; \q
exit

TODO: Will need to be changed as the new version shall be a library and no more a plain project copy.

make a new file (as root) in /etc/apache2/sites-available/koalixcrm.conf with the following content:

<VirtualHost *:80>
   ServerName koalixcrm.localdomain
   ServerAdmin youradminemail@yourhoster.com
   CustomLog /var/log/apache2/koalixcrm_access.log combined
   WSGIDaemonProcess koalixcrmprocess python-path=/var/www/koalixcrm python-home=/var/www/koalixcrm/env
   WSGIProcessGroup koalixcrmprocess
   WSGIScriptAlias /var/www/koalixcrm/koalixcrm/wsgi.py

   Alias /static /var/www/koalixcrm/static
   <Directory /var/Www/koalixcrm/static>
       Require all granted
   </Directory>
</VirtualHost>

edit the /etc/hosts (as root) in the following way, add in the first line the *koalixcrm.localdomain" 127.0.0.1 localhost koalixcrm.localdomain

a2ensite koalixcrm
service apache2 reload

cd /var/www/koalixcrm
python manage.py syncdb --all
python manage.py migrate --fake
/manage.py koalixcrm_install_defaulttemplates
sudo mkdir media/pdf
sudo chown www-data: media/pdf

What you wanna do next is of cause the test the software. Visit your http://localhost/admin, log in and start testing. To be able to do pdf exports you have to do something more. I advice you to do this with my default templatefiles by executing the installation script.

Clone this wiki locally