QaraTMS - Open Source Test Management System

QaraTMS is open source test management software for managing test suites, test cases, test plans, test runs and documentation.

Languages and Tools:

Getting Started

• You will need to install php ^8.0.2, mysql-8 or SQLite, composer.
• Pull the project from git repository.
• Create a database named tms utf8_general_ci, or you can use SQLite.
• Rename .env.backup file to .env and fill the database information.
• Run composer install or php composer.phar install
• Run php artisan key:generate
• Run php artisan migrate
• Run php artisan db:seed --class=AdminSeeder to create admin user and assign permissions.
• Run php artisan serve
• You can now access project at localhost:8000
• Login with default email and password - [email protected] / password
• Go to Users page and change default email and password.

If you are using SQLite:

• Create database.sqlite file in ./database folder
• Rename .env_sqlite.backup file to .env and fill the database information.

Getting Started with docker-compose (quick start)

• Install docker and docker-compose
• Make docker-run.sh file executable sudo chmod +x docker-run.sh and run ./docker-run.sh
• Or docker compose up -d --build and on the first run or after clearing the database or its volume docker exec app php artisan migrate and docker exec app php artisan db:seed --class=AdminSeeder to create admin user and assign permissions

Getting Started with docker-compose (extended)

• To access advanced configuration, refer to the extended documentation

How to use it

1. Create Project.

2. Create Test Repository. Test suites and test cases are located in test repository. You can create several test repositories for different project modules - web, admin, API, etc.

3. Add test suites and test cases.

4. Create test plan, select cases you need to test.

5. Start new test run.

6. Also, there is documentation module where you can store your project's documentation.

Contributing

Please contribute using GitHub Flow. Create a branch, add commits, and open a pull request.

License

QaraTMS is licensed under the MIT license.