Contribute to Percona Toolkit

We welcome community contributions to Percona Toolkit. Help improve the project by reporting bugs, suggesting documentation improvements, or contributing code.

Explore the following resources to find answers, learn best practices, and stay up to date with Percona Toolkit:

  • Percona Community Forum – Browse existing discussions, ask questions, and connect with the Percona community.

  • Percona Blog – Read technical articles, tutorials, and best practices for Percona Toolkit and MySQL.

Report an issue

Before creating a new issue, search the existing issues in Percona Jira to avoid duplicates. You can use this guide to structure the information.

When reporting an issue, include:

  • A clear and descriptive title.

  • The Percona Toolkit version.

  • Operating system and database version.

  • Steps to reproduce the issue.

  • The expected and actual results.

  • Error messages, logs, or other relevant details.

Documentation issues should be reported in the PT project in Percona Jira using the Documentation component.

Contribute to documentation

Documentation contributions of any size are welcome. You can help by:

  • Correcting typos or grammatical errors.

  • Improving explanations.

  • Adding examples or clarifying existing procedures.

  • Suggesting new content or topics.

Documentation updates can be submitted as GitHub pull requests.

Submit a pull request

  • Fork the Percona Toolkit GitHub repository.

  • Clone your fork to your local machine.

  • Create a branch for your changes.

  • Implement and test your changes.

  • Push the branch to your GitHub fork.

  • Open a pull request against the Percona Toolkit repository.

Contribute code

For detailed information about setting up the development environment, coding guidelines, testing, and submitting pull requests, see the Percona Toolkit GitHub contribution guide.

Contributor License Agreement

Before your contribution can be accepted, you must sign the appropriate Contributor License Agreement (CLA). Refer to the GitHub contribution guide for the available CLA options and submission instructions.

Additional resources