Jobsworth Project Management

Welcome to the jobsworth project management, support ticketing and CRM
system. This software is licensed under the AGPLv3.

Jobsworth can be used for helpdesk support ticketing, customer liasion,
resource management (eg. systems and password tracking) and has a range of
CRM type functionality. Plan your projects, see your schedule, know if
you're slipping behind and why. Time Tracking and extensive reports
help you show your clients exactly what you've done and for how long.

Support

The primary support is through the mailing list or if you
have a bug report, create
an issue in the tracker. If you want to write up details of a new
feature you'd like to see, please use the wiki.

Contributing

Code contributions are welcome to this project and the best way to go about
it is to fork the git repository:

https://github.com/ari/jobsworth

Please read the DEVELOPMENT.md file in this directory for more information.
Join the developer
mailing list to discuss ideas or ask questions.

Installing jobsworth on your server

Step 1: Database

Create a new database and user with full permissions to that database. You
can use mysql or postgresql.

Step 2: Servlet container

Install Apache Tomcat (or another java servlet container) and make sure you
can get to the default installation home page. How to install Tomcat or
some other servlet container is beyond the scope of these instructions but
the basic details can be found in the documentation.
Don't be afraid of all those XML configuration files in Tomcat; mostly
they can be left to default values.

There is one file you will need to edit and that is context.xml. This file
defines all the configuration for your application. Copy the example
into the tomcat configuration folder and set all the variables to
reasonable choices for your system.

Step 3: Install jobsworth

After all that setup we can now install the software. Just take the file
ROOT.war from the github release and
copy it into the webapps folder inside tomcat. If you ever need to upgrade
in the future, just replace that one file.

Step 4: Connect

Open a web browser and connect to your jobsworth server. The default user
is “admin” and password is “password”. Remember to change the password for
this user or disable it.

Optional: Set up email receiving

When jobsworth sends outgoing emails for task updates, they will have a
reply address which looks like this:

task-1234@acme.domain.com.au

If a user hits reply to that email, you want it to be appended to the task
comments. Here's how to set this up for sendmail; adapt the script for
your own mail server. Mail can be running on a different server to
jobsworth because we use HTTP to push the mail from your mail server to
jobsworth.

Sendmail

Add an entry to /etc/mail/local-host-names for your hostname:

acme.domain.com.au

Add an entry to /etc/mail/aliases to create an alias that will hand off
emails to a script

jobsworth: "|/usr/local/share/jobsworth/mail_script.sh"

Add an entry to /etc/mail/virtusertable to redirect all emails to your
domain to the above alias

@acme.domain.com.aujobsworth

run “make; make restart” in /etc/mail to rebuild the sendmail databases.

Now create a script at /usr/local/share/jobsworth/mail_script.sh with the
following contents