Providers

The providers block defines provider credentials and provider-specific settings.

Shape

providers:
  hosting:
    api_key: "${HOSTING_API_KEY}"

Projects reference a provider by key:

projects:
  api:
    provider: hosting

What Belongs Here

• credentials
• API endpoints or hosts when the provider requires them
• provider-specific identifiers that are shared across environments

What Does Not Belong Here

• profile branch selection
• profile domain names
• preview-only naming
• per-environment infrastructure decisions

Those belong in Profiles.

Capability Differences

Provider-specific fields and support levels are documented on provider pages:

• Ploi
• Laravel Forge
• cPanel
• EasyPanel

Failure Modes

• wrong credential variable names: match the provider page exactly
• using one provider config for a different provider plugin: keep keys and expectations aligned
• assuming every provider supports the same resources: check the provider feature matrix first