Remediation Agent
Customize the Remediation Agent's automated schedule for a single project in SonarQube Server 2026.5.
The SonarQube Remediation Agent proposes fixes for the issues found by analysis and opens pull requests for your review and approval. It's available in the Enterprise and Data Center editions and requires a separate subscription. An Instance Admin enables the agent and sets a default schedule for the instance. See Remediation Agent for the full details.
As a project administrator, you can keep the default schedule or define a custom remediation schedule for your project.
Customizing the schedule for your project
Go to Project settings > AI Capabilities > Remediation Agent.
Choose how the project follows the instance schedule:
Use default schedule: the project runs on the schedule set for the instance. The current default is shown, along with the maximum number of open pull requests.
Customize for this project: override the default schedule with a custom frequency for this project.
If you selected Customize for this project, set the Frequency, Day of week, Hour, and Timezone, then set Pause when open PRs reach or select Don't pause.
Select Save.
A summary confirms the next run time and states that each run opens one pull request for up to five issues in this repository.
You can return the project to the default schedule at any time.
When the agent isn't available for your project
The page explains why the agent cannot run and, if you're a project administrator, offers the action that resolves it:
The Remediation Agent is not enabled for this project
The agent hasn't been turned on for this project.
Project administrators can select Enable the Remediation Agent for this project. Otherwise, contact your administrator.
This project isn't bound to a repository
The agent has no repository to clone or open a pull request against.
Project administrators can select Set up project binding. Otherwise, contact your administrator.
Automated backlog remediation is not enabled for this project
The scheduler is off, so no scheduled runs happen. Manual assignment is unaffected.
Project administrators can select Enable Automated backlog remediation. Otherwise, contact your administrator.
Manual backlog remediation is not enabled for your SonarQube instance
Users cannot assign issues to the agent anywhere on this instance. This is an instance-level setting, unlike the row above.
Project administrators can select Enable Manual backlog remediation. Otherwise, contact your administrator.
Related pages
Last updated
Was this helpful?