> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watchtower.systems/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fixes for the most common issues when connecting, syncing, or running tests.

## Sync problems

**Sidebar shows "Last sync failed"**
Try clicking **Sync Codebase** again. If it keeps failing, check **Configuration → CI / Repos** for a connection health warning. Your GitHub connection may need to be re-provisioned or reconnected.

**"No tests found" after syncing**
Double-check the **Tests directory** and **Spec file extensions** under **Configuration → Codebase**. Watchtower only imports files that match both.

**A test I expected to see is missing**
There are two different reasons a test can disappear from view:

* If its title changed in your repository, Watchtower keeps it as an **abandoned** test rather than deleting it, so your history and comments aren't lost. Open it from Test Center's **Abandoned** filter and use **Rebind to a renamed test** to reconnect it.
* If its repository was recently unticked as your test source, the test is **archived** rather than removed. Reselect that repository as the test source under **Configuration → CI / Repos** and it comes back automatically.

See [Test Center](/v0.6.0/test-center#triage).

## Connection problems

**"Something went wrong connecting the repo"**
This usually means the GitHub App installation didn't complete, or access to the selected repository was revoked. Go to **Configuration → CI / Repos** and try **Connect GitHub** again.

**I disconnected a repository but it's still installed on GitHub**
Disconnecting in Watchtower only stops Watchtower from using that repository; it doesn't remove the GitHub App itself. Manage or fully revoke access from your GitHub account or organization settings.

**Unlink/Relink says a permission is missing**
Opening a pull request requires the **Pull requests: write** permission on Watchtower's GitHub App installation; committing directly requires **Contents: write**. Watchtower checks these before making any change and tells you which one is missing. Update the installation's permissions on GitHub, or use **Dashboard only** instead.

**A direct commit was rejected because the branch is protected**
Direct commits always target the repository's default branch. If that branch has protection rules that block direct pushes, use **Open a pull request** instead, changes made through a pull request go through your normal review process.

**Watchman isn't posting reviews**
Confirm AI analysis is turned on under **Configuration → Watchman**, and check that the **Review Target** is set to a destination that's actually available (GitHub is supported today; Linear is not yet available even though it's shown in the picker).

## Patrol problems

**A run's progress bar isn't moving smoothly**
For runs dispatched to CI, Watchtower can't see per-test progress until results are reported back; the progress indicator shows an indeterminate sweep rather than an exact percentage until the first results arrive. Check the console panel for live log output in the meantime.

**A run shows "No tests ran"**
This means the suite or grep filter matched nothing, or every matched test was skipped, rather than that the run failed. Check your **Test Suite** and **Grep Filter** selections and try again.

**I can't find my report after CI failed to upload it**
The provisioned workflow retries the report upload automatically, and also uploads the report as a workflow artifact named `watchtower-report` (kept for 7 days) regardless of whether the upload succeeded. Open the workflow run on GitHub and download it from the **Artifacts** section if needed.

**I can't change a test's status by hand**
If a test is controlled by Patrol (tagged `AUTO` and automated), its status reflects the most recent run and can only change by running Patrol again. This is by design, so automated results can't drift from manual edits.

**"'\<suite>' is already running"**
Only one run per suite can be active at a time. Wait for it to finish, or use **Cancel All** to stop it and start a new one.

## Reports & comparisons

**Compare says "Not enough data to compare"**
You need at least two recorded Patrol runs before Compare can show a delta. Run Patrol again and try once a second run has completed.

## Notifications

**Not receiving release emails**
Email release notifications are off by default. Turn them on under **Configuration → Codebase → Notifications**, and confirm your address is included as the repository owner or listed under **Additional recipients**. If they're still not arriving, confirm with your workspace admin that email delivery has been set up for your Watchtower instance.

## Workspace and invite problems

**"Workspace limit reached"**
You can own up to 5 workspaces. Delete one you no longer need, or ask to be invited into an existing one instead of creating a new one.

**An invite link says it's unavailable**
The invite may have expired (7 days for an email invite, 30 days for a link invite), already been used, or been revoked by an admin. Ask whoever invited you to send a new one.

**I can't rename or delete a workspace**
Renaming requires the **owner** or **admin** role; deleting requires **owner**. Your default workspace also can't be deleted.