A self-hosted Web file server and lightweight server management tool
Features • Screenshots • Installation • Quick Start
FileCat is a self-hosted Web file server and a lightweight server management tool. Once deployed, you can manage files on your server anytime and anywhere through a browser, while also enjoying a wide range of server management and operations features.
FileCat uses the UI of filebrowser.
Core philosophy: Centered around file management, FileCat integrates AI Agent, remote desktop, intranet tunneling, system monitoring, and other capabilities to make server management simpler.
| Category | Features |
|---|---|
| File Management | Browse, upload, download, edit, and preview files online (images, videos, Markdown, drawings, etc.) |
| AI Agent | Integrates large language models to assist with server management and file processing (API configuration required). Supports QQ, WeCom, Feishu, DingTalk, and other third-party platform bots |
| Intranet Tunneling | Expose services on an internal network to the public internet, or enable communication between multiple internal networks |
| SSH Terminal | Built-in Web terminal for connecting to servers anytime through a browser |
| Windows Remote Desktop | Directly operate remote Windows desktops (RDP) through a browser |
| System Information Dashboard | Real-time monitoring of CPU, memory, disk, network, and other system information |
| CI/CD Workflow | Create custom command pipelines for continuous integration and deployment |
| Large Log Viewer | Instantly open text log files of any size and efficiently locate problems |
| Excalidraw Drawing | Built-in whiteboard drawing tool |
| Multi-user Management | Comprehensive permission management system |
| Shareable Links | Generate file sharing links for convenient downloads |
| Multiple Path Mounts | Support mounting multiple filesystem paths |
| File List | AI Agent |
![]() |
![]() |
| Intranet Tunneling | System Information Dashboard |
![]() |
![]() |
Online demo: http://demo.filecat.xiaobaidadada.fun/
Username and password: demo/demo or test/test
The demo server is sponsored by Yecaoyun.
Minor bug fixes and feature updates are released and synchronized on npm in real time.
npm install -g filecatOn Linux, after installation, you can use pm2 to keep the process running, or register FileCat as a systemd service for process management.
curl -o install.sh https://filecat.xiaobaidadada.fun/files/linux-install.sh && bash install.shThe script automatically downloads the binary package and performs the installation. Simply follow the prompts to enter the required parameters.
Download the latest version for your operating system from Releases.
docker run -d --name filecat --restart=always --net=host \
-v /home:/home \
ghcr.io/xiaobaidadada/filecat:latest \
--port 5567 --base_folder /homegit clone https://github.com/xiaobaidadada/filecat.git
cd filecat
npm install
npm run dev # Development mode
# or
npm run build && node build/main.js # Production modeMethod 1: After installing via NPM:
filecat --port 5567Method 2: After extracting the binary package, run the filecat-run.sh script (Linux/Mac) or filecat-run.cmd script (Windows) included in the directory.
Default username/password: admin / admin
For more options, run
filecat --help.
Permission Notice: By default, FileCat can only access the installation directory after installation. Configure the directories and execution permissions accessible to each user in the settings.
-
Regular Upgrade: Upgrade according to your installation method:
- NPM:
npm -g i filecat - Docker: Pull the latest image again
- Binary: Download and replace the latest package
- NPM:
-
Automatic Upgrade (v5.33.0+): Run the
filecat-upgradecommand to automatically upgrade according to the installation environment. Docker and binary installations also support custom download URL parameters.
Join the QQ group 824838674 for discussion, feedback, and support.




