Skip to main content
ubx refresh syncs the local Pulumi state file with the actual state of cloud resources. Read-only — no cloud resources are created, updated, or deleted. Only the local state file is updated.

​
Usage

ubx refresh [flags]

​
Examples

ubx refresh                                          # refresh all resources
ubx refresh --target unit.aws_s3_bucket_v2.assets   # refresh one resource
ubx refresh --env prod                               # refresh prod stack

​
Flags

FlagDescription
--env stringTarget environment
--stack stringTarget stack name
--target stringArrayTarget a specific resource (repeatable)

​
Output

  ◆ Stack      dev

  ─── Refreshing ─────────────────────

  ~  aws:s3:BucketV2     assets   (drift detected: tags changed)
  ✓  aws:rds:Instance    db       (no changes)

  ✓  refresh complete

​
When to Use

  • After manual changes to cloud resources outside of ubx
  • Before ubx plan to ensure state is current
  • To detect drift between desired state and actual cloud state

​
Prerequisites

The .ubx/ directory must exist — run ubx apply at least once first: 
✗  ubx refresh: .ubx directory not found — run ubx apply at least once first