Documentation

openQA is an automated test tool that makes possible to test the whole installation process of an operating system in a wide combination of software and hardware configurations. This page lists some of the resources available to learn more about it.

Guides

openQA is free software released under the GPLv2 license. The documentation is hosted in the os-autoinst organization on GitHub (alongside the source code) and is divided into four documents that can be read directly from there.

The whole documentation in a single HTML file

This is a single page auto generated with all of the documentation available for openQA.

The whole documentation in a single PDF file

Same as above but as PDF document.

All individual documents

All documents and guides as individual files.

API documentation for testapi

Main test library documentation (os-autoinst-distri-opensuse)

Documentation of libraries used by the openSUSE and SLE tests.

Videos

There also many videos available covering various topics of openQA:

• SUSE QE Tools Workshop covering many topics
• Conference presentations on media.ccc.de
• Various videos on YouTube

Blogs and external resources

If you are contributing to openQA by writing posts, videos or podcasts consider adding a link to the list of external resources below:

• openqa-bites - Stories and tutorials from a humble openQA dev
• Liv's blog - Another openQA dev sharing useful guides and hints
• openSUSE reddit presence - The official openSUSE reddit presence. Sometimes openQA related questions come up here
• openQA twitter presence by openQAhq - X presence covering openQA by openQAhq
• openQA project management tool - organisation wiki for the openQA project
• SUSE QE generic project management tool - The generic entry page for SUSE QE related project management
• QA testing monthly call
• Linux Inlaws podcast featuring openQA - An episode featuring openQA on the Linux Inlaws Podcast
• Testing in a Box: Streamlining Embedded Systems Testing