Karvio Documentation
Karvio is a self-hosted test management system for QA teams that need one place for manual testing, automated result imports, release readiness, Jira defects, audit history, and performance evidence.
Start with installation if you are deploying Karvio. Start with Quick Start if the application is already running and you want to validate the core workflow.

Product Areas
| Area | Use it to |
|---|---|
| Test Cases | Build a repository of reusable manual or automation-linked cases organized by suites, owners, priorities, tags, datasets, and attachments. |
| Test Runs | Execute selected cases against a build, environment, and milestone; record results, comments, step outcomes, evidence, and defects. |
| Test Plans | Save recurring scopes such as smoke, regression, release acceptance, or platform coverage plans and create runs from them quickly. |
| Datasets | Maintain versioned parameter data so one test case can cover multiple input combinations. |
| Release Scope | Model products, components, risk, milestones, and release-ready test plans in one place. |
| Environments | Record the exact target configuration used for execution, including browser, OS, URL, feature flags, and infrastructure details. |
| Performance Testing | Store load-test artifacts, import supported results, compare executions, and keep performance evidence with release data. |
| Integrations | Connect Jira and CI output so defects and automated results are tied to the same testing record. |
| Project & Users | Manage projects, users, roles, project membership, and audit controls. |
Recommended Paths
For a first deployment:
- Installation – deploy the application and create the first administrator.
- Key Concepts – understand how projects, suites, cases, plans, runs, milestones, and environments fit together.
- Quick Start – create a project, add cases, execute a run, and review results.
For a QA team rollout:
- Test Cases – design a maintainable case repository.
- Test Runs – execute manual runs and record evidence.
- Release Scope – connect coverage to products, components, milestones, and plans.
- Jira Integration and JUnit XML Import – connect defects and automation.
Typical Team Workflow
flowchart LR
A["Create project"] --> B["Build suites and test cases"]
B --> C["Create plans for recurring scopes"]
C --> D["Start test runs for a build"]
D --> E["Record results and evidence"]
E --> F["Create or link Jira defects"]
E --> G["Review dashboards and milestones"]
G --> H["Adjust coverage for the next cycle"]
Administrator Guides
- Projects – create projects, define ownership, and understand deletion impact.
- Users and Permissions – manage users, roles, and project membership.
- Authorization – create secure credentials for CI and scripts.
- Notifications – configure email, Slack, and project-level notification rules.
Integration Guides
- Jira – create Jira connections, map projects, link issues, and create defects from failures.
- JUnit XML Import – import automation results into existing or new runs.
- API Reference – authenticate, paginate, inspect endpoints, and use example requests.