Frequently Asked Questions

General

What is Troy?

Troy is an independent plugin distribution system for WordPress. Developers host their own repositories; users receive updates directly—no centralized directory required.

Why "Troy"?

Like the ancient city that withstood siege, Troy is built for independence and resilience. And yes, there's a horse involved—but this one's here to help.

Is Troy free?

Yes. All Troy components are MIT licensed. Free as in freedom, free as in beer.

Who's behind Troy?

CyberWire B.V., led by Sybre Waaijer—the developer behind The SEO Framework.

Technical

Does Troy replace WordPress.org?

No. Troy only handles plugins that explicitly opt in via a Troy: header. Everything else continues through WordPress.org.

Can I use both?

Yes. Many developers list their free version on WordPress.org and distribute premium features via Troy. They coexist.

Is it secure?

• HTTPS only
• WordPress validates all plugin downloads
• Anonymous statistics (rotating UUID)
• Open source—audit it yourself

What about multisite?

Troy Client works on WordPress multisite. Network-activate it for site-wide coverage.

Troubleshooting

Updates aren't showing

1. Troy Client active? — Updates require Troy Client
2. Troy header present? — Your plugin needs Troy: server.com
3. Transients stale? — WordPress caches update checks
4. Server published? — Is the plugin public on your Troy Server?
5. Version higher? — Server version must exceed installed version

→ Troy Client Troubleshooting

Plugin won't auto-install

If Troy Embed or Installer fails:

1. Permissions — Does WordPress have write access to /plugins/?
2. Host restrictions — Some hosts block programmatic installs
3. Firewall — Can your server reach repo.deploytroy.org?

Fall back to manual: download ZIP, upload via Plugins → Add New.

GitHub sync errors

1. Token valid? — Personal Access Tokens expire
2. Format correct? — Use username/repo, not full URL
3. Releases exist? — Tags alone aren't enough; create GitHub Releases

→ GitHub Integration

Community

What's on the roadmap?

See the public roadmap. Highlights: GitLab/Bitbucket support, theme distribution, analytics dashboard.

How can I contribute?

GitHub — Bug reports, pull requests, documentation. All welcome.

Where can I get help?

• GitHub Discussions
• Discord