Skip to content

Latest commit

 

History

History

README.md

Testflinger Agent

Charmhub Documentation status codecov uv status Ruff status

Testflinger agent connects to the Testflinger Server to request and service test submissions.

Basic Usage

To start an agent process with a given configuration, simply run:

testflinger-agent -c /path/to/testflinger-agent.conf

Installation

Testflinger is available on all major Linux distributions.

The testflinger-agent-host charm provides a simple way to deploy multiple agents on a unified host which manages the agents as services with Supervisor.

On juju-ready systems, you can deploy the agent host on the command-line with:

juju deploy testflinger-agent-host

You can also install testflinger-agent as a Python package with pip:

pip install "testflinger-agent @ git+https://github.com/canonical/testflinger#subdirectory=agent"

Documentation

To learn more about the Testflinger agent configuration, deployment, and maintenance, refer to the following documentation sets:

Community and Support

You can report any issues, bugs, or feature requests on the project's GitHub repository.

Contribute to Testflinger

Testflinger is open source. Contributions are welcome.

If you're interested, start with the contribution guide.

License and Copyright

© 2025 Canonical Ltd.