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

# Files & FTP

> Browser-based file manager with disk analysis and FTP/SFTP server management for client access.

<Info>
  **Path:** Files (`/files`) → FTP Server (`/ftp`) — Admin only
</Info>

## File Manager

A full filesystem explorer running in your browser — no SSH client needed.

### File List

| Column          | Description                   |
| --------------- | ----------------------------- |
| **Name**        | File or folder with type icon |
| **Size**        | Human-readable file size      |
| **Modified**    | Last modification date        |
| **Permissions** | Unix permission string        |
| **Actions**     | Rename, chmod, delete         |

Navigate with the breadcrumb path at the top.

### Actions

| Action                   | Description                                    |
| ------------------------ | ---------------------------------------------- |
| **Create file / folder** | Toolbar buttons                                |
| **Upload**               | Drag-and-drop or picker with live progress bar |
| **Rename**               | Opens rename modal                             |
| **Change permissions**   | Octal chmod input                              |
| **Delete**               | Permanent — no trash                           |
| **Download**             | Single-file download                           |
| **Show hidden files**    | Toggle to include dotfiles                     |
| **Search**               | Search box with file-type icons in results     |

### File Editor

Click any text file to open the right-side preview panel:

* File info: size, owner, group, MIME type
* Toggle between **Read** and **Edit** mode
* Inline save/cancel

Supported formats: PHP, HTML, CSS, JS, YAML, JSON, Nginx config, shell scripts.

***

## Disk Usage Sidebar

Collapsible panel with three sections:

**Partitions** — all mounted filesystems with a percentage bar, device name, and used/total size.

**Directory Analysis** — toggle between:

* **Top Directories** — largest subdirectories with percentage bars
* **Largest Files** — top 10 files by size

**File Type Breakdown** — donut chart showing disk usage by category (images, video, code, archives, etc.).

***

## FTP Server

**Path:** `/ftp`

### Status Cards

| Card              | Shows                   |
| ----------------- | ----------------------- |
| **Status**        | Running / Stopped       |
| **Active Server** | vsftpd or ProFTPD       |
| **Users**         | Total FTP accounts      |
| **Connections**   | Live active connections |

Install by clicking **Install** and choosing vsftpd or ProFTPD.

### Tabs

<AccordionGroup>
  <Accordion title="Overview" icon="gauge">
    Configuration display — port, anonymous access, local users, write permission, chroot, SSL/TLS — and a connection info grid.
  </Accordion>

  <Accordion title="Users" icon="users">
    All FTP accounts with username, home directory, and status. **Create User** opens a modal: username, password (with auto-generate), home directory.

    Per-user actions: **Change Password**, **Enable/Disable**, **Delete**.
  </Accordion>

  <Accordion title="Connections" icon="wifi">
    Live connections — local/remote addresses, state, and a **Disconnect** button. Auto-refreshes.
  </Accordion>

  <Accordion title="Logs" icon="file">
    Raw FTP server log output. Refresh button to reload.
  </Accordion>
</AccordionGroup>

<Tip>
  FTP users are chrooted to their home directory and cannot access other server paths. Share credentials with clients so they can upload files to their site root without needing SSH.
</Tip>