0
0
Fork 0
mirror of https://github.com/kevinpapst/kimai2.git synced 2025-03-15 21:44:46 +00:00
No description
Find a file
2018-01-10 23:20:36 +01:00
app added missing translation file for pagerfanta 2018-01-10 23:20:16 +01:00
bin first draft 2016-10-20 22:10:41 +02:00
src hide inactive delete user button #78 (#79) 2018-01-10 23:14:58 +01:00
tests added toolbar to user screen #56 (#66) 2018-01-09 17:15:07 +01:00
var updated packages 2018-01-01 17:49:59 +01:00
web added delete timesheet records action for users #67 (#72) 2018-01-09 21:47:32 +01:00
.gitignore ignore files 2018-01-01 16:20:10 +01:00
.travis.yml first draft 2016-10-20 22:10:41 +02:00
app.json first draft 2016-10-20 22:10:41 +02:00
composer.json added toolbar to user screen #56 (#66) 2018-01-09 17:15:07 +01:00
composer.lock update avanzu admin bundle to newest version #55 (#63) 2018-01-09 12:42:11 +01:00
CONTRIBUTING.md code cleanup 2018-01-05 10:41:32 +01:00
LICENSE first draft 2016-10-20 22:10:41 +02:00
phpunit.xml.dist first draft 2016-10-20 22:10:41 +02:00
README.md updated README 2018-01-10 23:20:36 +01:00

Kimai v2 - Time Tracking

Kimai v2 - the reloaded open source Time-Tracking application.

Build Status

Introduction

This is (or will be in the future, currently a lot of features are still missing) the reloaded version of the open source time-tracking application Kimai.

It is based on the following PHP components:

Requirements

If unsure about meeting these requirements, download the demo application and browse to the http://localhost:8000/config.php script to get more detailed information.

Installation

First, install Git and Composer if you haven't already. Then, clone this repo and execute this command in the cloned directory:

$ git clone https://github.com/kevinpapst/kimai2.git
$ cd kimai2/

Lets prepare the environment by installing all dependencies. You will be asked for your application parameter, like the database connection afterwards (if you don't have a app/config/parameters.yml yet):

$ composer install

The next command will create the database, the schema and install all web assets:

$ bin/console kimai:install --relative

Installation (live)

All thats left to do is to create your first user:

$ bin/console kimai:create-user admin admin@example.com password en ROLE_SUPER_ADMIN

For available roles, please refer to the user documentation.

Installation (development / demo)

Lets boostrap your environment by executing this commands (which is only available in dev environment):

$ bin/console kimai:dev:reset

You just imported demo data, to test the application in its full beauty and with several different user accounts and permission sets.

You can now login with these accounts:

Username Password Role
clara_customer kitten Customer
john_user kitten User
chris_user kitten User (deactivated)
tony_teamlead kitten Teamlead
anna_admin kitten Administrator
susan_super kitten Super-Administrator

Demo data can always be deleted by dropping the schema and re-creating it. ATTENTION - this will erase all your data:

$ bin/console doctrine:schema:drop --force
$ bin/console doctrine:schema:create

The kimai:dev:reset command can always be executed later on to reset your dev database and cache. I use it very frequently.

Usage

There is no need to configure a virtual host in your web server to access the application for testing. Just use the built-in web server for your first tests:

$ APP_FRONT_CONTROLLER=app.php bin/console server:run

This command will start a web server for Kimai. Now you can access the application in your browser at http://127.0.0.1:8000/. You can stop the built-in web server by pressing Ctrl + C while you're in the terminal.

NOTE

If you want to use a fully-featured web server (like Nginx or Apache) to run Kimai, configure it to point at the web/ directory of the project. For more details, see: http://symfony.com/doc/current/cookbook/configuration/web_server_configuration.html

Troubleshooting

Cannot see any assets (like images) and/or missing styles? Try executing:

$ php bin/console assets:install --symlink