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

# Files

> Browse and edit files on your VM — including inside app volumes — directly in the dashboard.

The **Files** tab gives you a tree-style file browser and a Monaco-grade code editor in the browser. No SSH or `scp` required.

## Picking what to browse

The selector at the top of the Files tab chooses the root:

* **VM home** (`/root` on the host) — the host's filesystem, scoped to the home directory.
* **An app install's volume** — the named docker volume for that install. For OpenClaw that's `/home/node/.openclaw`; for n8n it's `/home/node/.n8n`; etc.

Switching the selector reloads the tree at the new root.

## What you can do

* **Navigate** with click / breadcrumb / `..` button.
* **Open** files in a modal editor with syntax highlighting for JSON / YAML / JS / TS / Markdown / SQL / shell / and many more.
* **Edit + Save** — `Cmd-S` / `Ctrl-S` to save. The editor has full undo (`Cmd-Z`), find (`Cmd-F`), bracket matching, and lint markers for JSON.
* **Format** — for JSON and YAML, a Format button reflows the document to a canonical layout.
* **Download** any file to your local machine.
* **Rename** files or folders.
* **Archive selected** — pick multiple entries and download as a `.tar.gz`.

## Editing config files for apps

A common workflow:

1. Switch root to the app's volume.
2. Open the config file (e.g. `openclaw.json`, `config/production.json`).
3. Edit the value.
4. `Cmd-S` to save.
5. Go to the install's detail page and click **Restart** so the app picks up the change.

<Note>
  Most apps watch their config and reload automatically — restart only when you've changed something fundamental like a bind address or a database connection string.
</Note>

## Path traversal protection

The Files tab won't let you escape the selected root. `../../../etc/passwd` URLs from anywhere in the path are rejected. If you need root-of-disk access, use the host terminal instead.

## Limits

* Max file size for editing: 1 MB. Larger files (up to 50 MB) are read-only via Download.
* Binary files are detected and downloaded rather than opened in the editor.
* Hidden files and dotfiles are shown by default.

## Next

<CardGroup cols={2}>
  <Card title="Terminal" icon="terminal" href="/manage-vm/terminal">
    Shell access for things the Files tab can't do.
  </Card>

  <Card title="Logs" icon="rectangle-list" href="/manage-vm/logs">
    Live container output.
  </Card>
</CardGroup>