# faros sandbox

Drive a development-mode instance: sync, exec, logs, restart, status

Source: https://faros.sh/docs/reference/cli/commands/sandbox/

<!-- Generated by scripts/sync-cli-docs.py from faroshq/faros docs/cli. Do not edit by hand; run `make sync-cli-docs`. -->

## Synopsis

Drive a development-mode infrastructure Instance (for an App Studio project,
\<project>-dev) through the hub data plane, as you.

Component paths are relative to the component's workspacePath: for the
application template, sync api/ to component "api" and web/ to "web".
Production instances answer 409.

```bash
faros sandbox sync    shop-dev api ./api
faros sandbox exec    shop-dev api -- node -e 'console.log(1)'
faros sandbox logs    shop-dev api -f
faros sandbox restart shop-dev api
faros sandbox env     shop-dev api PULSE_URL=https://… --restart
faros sandbox status  shop-dev [api]
```

## Options

```text
  -h, --help               help for sandbox
      --org string         Organization display name or UUID (default: the org that owns the kubeconfig's workspace)
      --workspace string   Workspace display name or UUID (default: the workspace the kubeconfig points at)
```

## Inherited options

```text
      --insecure-skip-tls-verify   Skip TLS certificate verification when talking to the hub
      --kubeconfig string          Path to the kubeconfig file (default: $KUBECONFIG, then ~/.kube/config)
```

## See also

- [faros](https://faros.sh/docs/reference/cli/commands/) — faros: an open-source control plane for platform teams
- [faros sandbox env](https://faros.sh/docs/reference/cli/commands/sandbox-env/) — Set environment variables on the component's running dev process
- [faros sandbox exec](https://faros.sh/docs/reference/cli/commands/sandbox-exec/) — Run a command in the component and exit with its exit code
- [faros sandbox logs](https://faros.sh/docs/reference/cli/commands/sandbox-logs/) — Print the dev process log
- [faros sandbox restart](https://faros.sh/docs/reference/cli/commands/sandbox-restart/) — Restart the component's dev process
- [faros sandbox status](https://faros.sh/docs/reference/cli/commands/sandbox-status/) — Show the instance status, or a component's process state
- [faros sandbox sync](https://faros.sh/docs/reference/cli/commands/sandbox-sync/) — Push a directory into the component workspace (authoritative)