Marketplace blueprints are the same kind/spec as custom blueprints — the difference is that Ryvn maintains them and keeps them updated as cloud providers change their managed offerings. A blueprint’s
distribution is private (the default for custom blueprints), marketplace-unmanaged, or marketplace-managed; a private blueprint reaches other organizations only through a resource share, never through the marketplace.Installing a marketplace blueprint
Marketplace blueprints are referenced using theryvn.app/ prefix. You can install them from the Dashboard, via infrastructure as code, or using the CLI.
From the Dashboard
- Open the Blueprints page and select the Marketplace tab.
- Click on a blueprint to view its inputs, outputs, and description.
- Click Actions → Install and select the target environment.
- Configure the inputs and confirm.
Via infrastructure as code
Reference marketplace blueprints in aBlueprintInstallation resource using the ryvn.app/ prefix on the blueprint name:
BlueprintInstallation resource — the only difference from a custom blueprint installation is the ryvn.app/ prefix on the blueprint name. All the same properties apply: inputs, releaseChannel, excludedInstallations, etc.
Via the CLI
Create a blueprint installation from the command line:Configuring inputs
Each marketplace blueprint defines a set of inputs that you can customize. Inputs with default values are optional — you only need to provide values for required inputs or when you want to override a default. To see the available inputs for a blueprint:Secret inputs
Some inputs are marked as secrets (e.g., database passwords). These are handled securely:- Generated secrets: If the input has a
generatedconfiguration, a value is automatically created when the blueprint is installed. You don’t need to provide it. - Variable groups: You can bind a secret input to a key in an environment variable group using
valueFromVariableGroup:
Variable groups
Formap type secret inputs, you can reference an environment-scoped variable group:
Consuming blueprint outputs
Marketplace blueprints expose typed outputs — database endpoints, connection strings, credentials — that your services can reference directly. When outputs change, any services that reference them are automatically redeployed.Environment variables
UsevalueFromOutput to inject blueprint outputs into your service’s environment:
Secrets
Secret outputs (like passwords and connection strings) must be consumed viavalueFromOutput: