Troubleshooting

How Updates Work

Understanding the update cycle helps diagnose issues:

1. WordPress checks for updates automatically (usually twice daily via WP-Cron, or when you visit Dashboard → Updates)
2. Troy Client intercepts this check for Troy-enabled plugins
3. Cached responses are used if available (default: 10 minutes)
4. Fresh requests are made to each Troy Server if the cache is stale
5. Results appear in your normal WordPress updates screen

The Cache

Troy Client caches API responses to reduce server load. Default: 10 minutes.

Force a fresh check:

// Add temporarily, reload any admin page, then remove:
delete_site_option( 'troy_client_api_request_cache' );

Or visit Dashboard → Updates and click Check Again (after cache expires).

About the Cache Size

Troy Client limits cache to ~333KB of serialized data. This accommodates roughly 20 plugins with full metadata—more than enough for typical use. It's one of many micro-optimizations ensuring Troy doesn't bloat your database or slow your site.

The math: a typical plugin's update response is ~15–17KB serialized. At 333KB, that's about 20 plugins before older entries get purged.

Updates Not Appearing

Checklist:

1. ✓ Troy Client active? Check Plugins screen
2. ✓ Plugin has Troy header? Look for * Troy: repo.example.com in the plugin file
3. ✓ Server version is higher? Troy compares version numbers
4. ✓ Cache cleared? Wait 10 minutes or clear manually
5. ✓ Troy Server online? Visit https://their-repo.com/ping in your browser

Won't Activate

Requirements:

Check your versions in Tools → Site Health → Info.

Connection Errors

If Troy Client can't reach a server:

1. Server down? Test the URL in your browser
2. Host blocking outbound? Some hosts restrict HTTPS connections—contact them
3. Security plugin interference? Temporarily disable to test

Updates Fail to Install

1. Check disk space
2. Verify wp-content/plugins is writable
3. Manual fallback: download ZIP from developer, delete old plugin, upload new one

Still Stuck?

• Contact your plugin developer—they can check their Troy Server logs
• Community Discord