FileCodeBox # FileCodeBox ### Share files like picking up a package A lightweight, modern, self-hosted file sharing service. No account required—upload, share the passcode, and retrieve. [Live Demo](https://share.lanol.cn) · [Documentation](https://fcb-docs.aiuo.net/en/) · [简体中文](./readme.md) [![Release](https://img.shields.io/github/v/release/vastsa/FileCodeBox?style=flat-square&color=111111)](https://github.com/vastsa/FileCodeBox/releases/latest) [![Docker Pulls](https://img.shields.io/docker/pulls/lanol/filecodebox?style=flat-square&logo=docker&color=111111)](https://hub.docker.com/r/lanol/filecodebox) [![Stars](https://img.shields.io/github/stars/vastsa/FileCodeBox?style=flat-square&logo=github&color=111111)](https://github.com/vastsa/FileCodeBox/stargazers) [![License](https://img.shields.io/github/license/vastsa/FileCodeBox?style=flat-square&color=111111)](./LICENSE)
FileCodeBox
## Start with one command ```bash docker run -d --restart unless-stopped \ -p 12345:12345 \ -v ./data:/app/data \ -e APP_ENV=production \ -e LOG_LEVEL=warning \ --log-opt max-size=10m \ --log-opt max-file=3 \ --name filecodebox \ lanol/filecodebox:2.9.0 # x-release-please-version ``` Open `http://localhost:12345` and complete first-run setup. Pin a version in production; `latest` tracks the newest stable release. ## MCP for AI clients FileCodeBox supports **MCP over Streamable HTTP**, allowing compatible AI clients to create text and file shares. Use `http://:12345/mcp` (or `http://localhost:12345/mcp` for a local instance). No token is required by default. The available tools are `share_text` and `share_file`. If guest uploads are disabled or MCP token validation is enabled, configure `Authorization: Bearer ` in the client. See the [MCP integration guide](https://fcb-docs.aiuo.net/en/guide/mcp). ## Simple, yet capable
Share instantly
Files and text in one flow, with drag, paste, batch, and chunked uploads.
Expire on your terms
Expire by time or retrieval count, keep forever, and clean up automatically.
Own your data
Local, S3, OneDrive, WebDAV, and OpenDAL storage on infrastructure you control.
## From sharing to administration
File sharing screen Admin dashboard
Admin login File management System settings
`FastAPI` `Vue 3` `SQLite` `Docker` `S3` `WebDAV` `Dark Mode`
## Learn more - [Getting started](https://fcb-docs.aiuo.net/en/guide/getting-started) · deployment, setup, and upgrades - [Storage](https://fcb-docs.aiuo.net/en/guide/storage) · local and object storage - [Security](https://fcb-docs.aiuo.net/en/guide/security) · rate limits, sessions, and access protection - [API reference](https://fcb-docs.aiuo.net/en/api/) · upload, retrieval, and administration - [Frontend source](https://github.com/vastsa/FileCodeBoxFronted) · the active 2024 theme ## Contributing [Issues](https://github.com/vastsa/FileCodeBox/issues/new/choose) and pull requests are welcome. FileCodeBox is released under [LGPL-3.0](./LICENSE). ## Disclaimer Use FileCodeBox only for lawful file and text sharing. Do not upload, store, or distribute illegal, infringing, or unauthorized content. Operators are responsible for deployment security, data compliance, and content moderation.
**If FileCodeBox helps you, consider leaving a Star.**