> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ubiquex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ubx refresh

> Sync local Pulumi state with actual cloud resource state.

`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

```bash theme={null}
ubx refresh [flags]
```

## Examples

```bash theme={null}
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

| Flag                   | Description                             |
| ---------------------- | --------------------------------------- |
| `--env string`         | Target environment                      |
| `--stack string`       | Target stack name                       |
| `--target stringArray` | Target 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
```