/thebuggenie

The Bug Genie is a friendly project management and issue tracking tool

Primary LanguagePHPMozilla Public License 2.0MPL-2.0

The Bug Genie

Build Status Join the chat at https://gitter.im/thebuggenie/general

The Bug Genie is an enterprise-grade issue-tracking, development and project management system. Main features includes:

  • Integrated wiki
  • Live project planning
  • Great agile project support
  • Customizable workflow support
  • Time tracking
  • Multiple hosted installations on single setups
  • Complete source code integration
  • Command-line interface for both local and remote installations
  • LDAP authentication, OAuth2-enabled logins and pluggable auth backend
  • Remote API (JSON-based)
  • Great web-based configuration
  • Module-based and extensible architecture
  • Integration with source-code control systems

... and a lot more!

For up-to-date installation and setup notes, visit the FAQ: https://issues.thebuggenie.com/wiki/TheBugGenie:FAQ

Installation

1: Download and install Composer

The Bug Genie uses a dependency resolution tool called Composer, which must be downloaded and run before The Bug Genie can be installed or used.

Download and install Composer from http://getcomposer.org

2: Install The Bug Genie dependencies

After you have followed the instructions in step 1, run php composer.phar install from the main directory of The Bug Genie. Composer will download and install all necessary components for The Bug Genie, and you can continue to the actual installation as soon as it is completed.

3a: Install via web

Visit the subfolder https://example.com/thebuggenie/public/index.php in your web-browser.

The installation script will start automatically and guide you through the installation process.

3b: Install via command-line (unix/linux only)

You can use the included command-line client to install, if you prefer that. The command line utility can be found in the root folder: $ php ./tbg_cli

To install: $ ./tbg_cli install

REPORTING ISSUES

If you find any issues, please report them in the issue tracker on our website: https://issues.thebuggenie.com

RUNNING PHPUNIT TESTS

By executing composer.phar install --dev during the installation process, phpunit 4.2 will get installed. The phpunit test can be run by the following command:

vendor/bin/phpunit

Development and testing using Vagrant

If you are interested in contributing some code to The Bug Genie, you can get quickly up and running using the provided Vagrant and Ansible configuration. This can save you both time, and reduce the number of software packages you need to install and configure for working with The Bug Genie.

Take note that provided configuration and set-up should not be used in production.

For more details and some introduction see The Bug Genie wiki page.