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

# Mount a sandbox

> Mount a ready SandyWP sandbox as a local folder with the SandyWP CLI.

`sandywp mount <name>` makes a sandbox's WordPress files available as a local folder. Open that folder in an editor or use normal local tooling; saved changes are written through to the live sandbox.

## Quick start

Install and authenticate the [CLI](/cli), then mount a ready sandbox you own.

```sh theme={null}
npm install -g @sandywp/cli
sandywp auth login
sandywp mount my-site
```

By default, the mount is created at `~/SandyWP/my-site`. Use `--path <directory>` to choose a different destination.

Mounting requires a paid-plan, account-owned sandbox and a FUSE provider on macOS or Linux. It is not directly supported on Windows; use WSL or [SSH access](/guides/ssh-access).

## Requirements

The CLI manages the required file-transfer client. You install FUSE once per computer.

<Tabs>
  <Tab title="macOS">
    ```sh theme={null}
    brew install --cask fuse-t
    ```

    `macFUSE` is also supported.
  </Tab>

  <Tab title="Linux">
    ```sh theme={null}
    # Debian or Ubuntu
    sudo apt install fuse3

    # Fedora
    sudo dnf install fuse3
    ```
  </Tab>
</Tabs>

## Work with the mounted folder

```sh theme={null}
code ~/SandyWP/my-site
cd ~/SandyWP/my-site
```

Use your editor, `git`, `rg`, or other local development tooling normally. Work in `wp-content` for themes, plugins, and mu-plugins, then refresh the sandbox to see the change.

## Lifecycle and cleanup

A mount uses a short-lived key that lasts up to 24 hours or the sandbox's remaining lifetime, whichever is shorter. It is not renewed automatically.

```sh theme={null}
sandywp mounts
sandywp unmount my-site
sandywp unmount --all
```

If `sandywp mounts` shows `KEY EXPIRED` or `DEAD`, unmount and mount the sandbox again. Use [SSH access](/guides/ssh-access) when a FUSE mount is not an option.
