# Configure System Tools

> Upload, install, and update packaged custom system tool plugins in the FastGPT admin console for platform-wide team access.

Source: https://doc.fastgpt.io/guide/build/tools/system-plugins/upload_system_tool
Last Updated: 2026-11-12

> Starting from FastGPT 4.14.0, system admins can upload and update system tools directly through the web interface for hot reloading.

## Permission Requirements

⚠️ **Important**: Only **root users** can use the online system tool upload feature.

* Make sure you are logged in with the `root` account

## Supported File Formats

* **File type**: `.pkg` files, or `.zip` files containing multiple `.pkg` files
* **File size**: Controlled by the `UPLOAD_FILE_MAX_SIZE` environment variable, 1000 MB by default
* **File count**: Controlled by the `UPLOAD_FILE_MAX_AMOUNT` environment variable, up to 1000 files per upload by default

## Upload Steps

### 1. Access the Configuration Page

Log in as `root`, open **Admin → System Resources → System Tools**, click **+ New Tool** in the upper-right corner, and select **Install from local** from the dropdown menu (which also provides **Install from Plugin Marketplace**).

![Configuration resource library and Add Resource entry](https://cdn.jsdelivr.net/gh/labring/fastgpt-img@main/optimized/plugins/entry.png.webp)

### 2. Prepare Tool Files

Prepare a `.pkg` file from a trusted author and confirm compatibility with the target environment. For custom tools, follow [build, check, and pack](https://doc.fastgpt.io/plugin/debugging-and-publishing#build-check-pack). See the [package and SDK reference](https://doc.fastgpt.io/plugin/package-reference) for artifact details.

![Packaged system tools in the dist/pkgs directory](https://cdn.jsdelivr.net/gh/labring/fastgpt-img@main/optimized/plugins/files.png.webp)

### 3. Upload

1. Click **+ New Tool → Install from local** in the upper-right corner
2. In the **Import/update Plugin** drawer that opens, click the file selection area
3. Select your prepared `.pkg` or `.zip` tool files
4. After confirming the file details, click **Confirm import** at the bottom

### 4. Upload Process

* A success message will appear after the upload completes
* The page auto-refreshes and the new tools will appear in the tool list

## Features

### Tool Management

* **View tools**: Users see available system tools according to their status and permissions
* **Upload tools**: Only root users can upload new tools or update existing ones
* **Delete tools**: Only root users can delete uploaded tools

## Configuration after installation

Root administrators can manage status, system secrets, and [runtime parameters](https://doc.fastgpt.io/plugin/runtime) in the tool configuration page. Verify a call in a test App after installation or an update.

| Status                          | New tool selection    | Existing calls |
| ------------------------------- | --------------------- | -------------- |
| Normal                          | Available             | Continue       |
| Hidden                          | Hidden from selectors | Continue       |
| Pending offline (`SoonOffline`) | Hidden from selectors | Continue       |
| Uninstalled (`Offline`)         | Unavailable           | Rejected       |

Root administrators configure system secrets centrally. The FastGPT server stores them and reads them when a call selects system secrets. [Team installations](https://doc.fastgpt.io/plugin/team-installation) keep their own configuration and secrets.
For missing installation entries or parameter troubleshooting, see [App, Chat, and Plugin FAQ](https://doc.fastgpt.io/guide/build/faq).
