These docs have been generated using AI. Expect inaccuracies until we remove this banner.
Installation
Troy is designed to get out of your way. Pick your role, follow the steps, you're done.
Which One Do You Need?
| You are a... | Install | What it does |
|---|---|---|
| Site owner using plugins from a Troy developer | Troy Client | Receives updates from Troy Servers |
| Plugin developer who wants to distribute independently | Troy Server | Hosts your plugin repository |
Most people just need Troy Client:
If a plugin developer gave you a ZIP file or asked you to install Troy Client, that's all you need.
Troy Client
For site owners receiving plugin updates from Troy-enabled developers.
Requirements: WordPress 6.7+, PHP 7.4+
Download
Download Troy Client from your plugin developer, or from the official repository:
Upload
In your WordPress admin:
- Go to Plugins → Add New
- Click Upload Plugin
- Choose the ZIP file and click Install Now
Activate
Click Activate Plugin. That's it.
Troy Client now automatically detects Troy-enabled plugins and manages their updates. No configuration needed.
Troy Server
For plugin developers who want to host their own update repository.
Requirements: WordPress 6.8+, PHP 8.4+, MySQL 8.0.19+
Download the Package
The Troy Server installer package includes both Troy Client and Troy Server:
Upload
In your WordPress admin:
- Go to Plugins → Add New
- Click Upload Plugin
- Choose the ZIP file and click Install Now
Activate & Configure
- Click Activate Plugin
- The installer sets up Troy Client and Troy Server automatically
- Go to Settings → Troy Server to configure your repository
Your Troy Server is now ready. Add your first plugin.
Multisite
Troy Client requires network activation on WordPress Multisite. Upload and activate it from the Network Admin plugins screen.
Next Steps
- Site owners: You're done. Updates will appear in your dashboard like any other plugin.
- Developers: Add your first plugin to Troy Server
