Groundfloor Docs

Environment Promotion

Compare and promote secrets, feature flags, Shell apps, and coderunners across dev, staging, and prod.

Environment Promotion moves configuration and artifacts from a source environment to a target (typically dev → staging → prod) without copying customer vault data or changing public URLs.

Pillar #10· Environment Promotion✅ Live

What you can promote today

ChannelBehavior
SecretsInfisical keys; values never appear in the diff; skip or overwrite on conflict
Feature flagsTyped values shown in the diff
Shell appsPublished federated releases; target siblings created when missing
CoderunnersRedeploy the source version onto a target sibling (may trigger background build/deploy)

Vault / Dataplane customer data is not promoted. Namespace rewrite and public host remapping remain deferred.

Promote in the portal

Open Environments

Sidebar → Build → Environments. Select a workspace.

Choose source and target

Pick the environments to compare (for example staging → prod).

Review each channel

Open the Secrets, Feature flags, Apps, and Coderunners panels. Review the diff, choose skip/overwrite where offered, then promote.

Prerequisites

  • Workspace with at least two environments (created with the workspace)
  • Published Shell releases and/or coderunner deployments when promoting those channels
  • Secrets and flags already managed in the source environment
  • GET/POST …/secrets/compare and …/promote
  • GET/POST …/flags/compare and …/promote
  • GET/POST …/apps/compare and …/promote
  • GET/POST …/coderunners/compare and …/promote

Coderunner

Create, upload, deploy, and run standalone functions, jobs, schedules, and services from the Customer Portal.

Feature Flags

Manage per-environment typed feature flags and promote them across environments.

On this page

What you can promote todayPromote in the portalOpen EnvironmentsChoose source and targetReview each channelPrerequisitesRelated APIRelated