/platform/environments/mappings) holds the fan-out mappings from vault secrets to runtime deployment targets. The page header reads Environments. It is the Mappings tab of the Secrets tab group, after Vaults, Connections, and Instances; Secrets opens from the Secrets tab of Settings under Platform. Open it to send a secret to a deployment as an environment variable, or to see whether the last deploy succeeded.


Secret mappings — Forge Console at /platform/environments/mappings
What you can do
- Filter by Vault (default All Vaults). Mappings appear only once a vault is selected; the choice is kept in the URL as
?vault=. - + Add Mapping opens the mapping form: a vault secret, an instance, and the destination key it deploys as.
- Deploy All (shown once a vault is selected) deploys every mapping in that vault.
- Deploy on a row deploys that one mapping.
- The row menu offers Edit and Delete. Delete asks for confirmation; the secret no longer deploys to that instance.
Columns
Deploy status
A row’s deploy status isidle, pending, success, or failed, shown as an icon next to Deploy. A failed deploy shows its error, or “Deploy failed.”.
Who can act
- Viewing requires
vaults:read; + Add Mapping appears only withvaults:manage. - Deploy also requires membership in the target instance. Without it, the button stays disabled with “Membership required. Go to Instances → ⋮ → Manage members to grant deploy access.”
Without
vaults:read the page says “You need the secret_mappings:read permission to view Mappings.” The permission it checks is vaults:read.Key state to watch
failedon a row: the secret did not reach the instance. Read the error, fix the instance connection or the key, then Deploy again.- “Mapping references a deleted resource — remove this mapping to clean up.”: the secret or instance is gone; delete the mapping.
- A disabled Deploy with “Membership required”: add yourself on Instances through Manage Members.
- A Last Deployed date older than the secret’s latest rotation: deploy the mapping so the target receives the current version.

