2023-09-06 11:40:13 +08:00
<div align="center">
2025-01-26 10:57:46 +08:00
2026-07-11 23:00:24 +08:00
<img src="./docs/public/logo_small.png" alt="FileCodeBox" width="96" />
2026-07-11 22:48:52 +08:00
2026-01-25 14:12:20 +08:00
# FileCodeBox
2025-01-26 10:57:46 +08:00
2026-07-11 23:00:24 +08:00
### Share files like picking up a package
2025-01-26 10:57:46 +08:00
2026-07-11 23:00:24 +08:00
A lightweight, modern, self-hosted file sharing service. No account required—upload, share the passcode, and retrieve.
2025-01-26 10:57:46 +08:00
2026-07-11 23:00:24 +08:00
[Live Demo ](https://share.lanol.cn ) · [Documentation ](https://fcb-docs.aiuo.net/en/ ) · [简体中文 ](./readme.md )
2026-01-25 14:12:20 +08:00
2026-07-11 23:00:24 +08:00
[](https://github.com/vastsa/FileCodeBox/releases/latest)
[](https://hub.docker.com/r/lanol/filecodebox)
[](https://github.com/vastsa/FileCodeBox/stargazers)
[](./LICENSE)
<br />
2026-07-24 16:34:22 +08:00
<img src="./.github/images/readme/banner_en.webp" alt="FileCodeBox" width="100%" />
2026-01-25 14:12:20 +08:00
2026-07-11 22:48:52 +08:00
</div>
2026-01-25 14:12:20 +08:00
2026-07-11 23:00:24 +08:00
## Start with one command
2026-01-25 14:12:20 +08:00
```bash
2026-09-01 23:56:08 +08:00
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 \
2026-11-16 07:45:26 +00:00
lanol/filecodebox:2.9.0 # x-release-please-version
2026-01-25 14:12:20 +08:00
```
2025-01-26 10:57:46 +08:00
2026-07-11 23:00:24 +08:00
Open `http://localhost:12345` and complete first-run setup. Pin a version in production; `latest` tracks the newest stable release.
2026-10-12 18:37:31 +08:00
## MCP for AI clients
FileCodeBox supports **MCP over Streamable HTTP** , allowing compatible AI clients to create text and file shares. Use `http://<your-server>: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 <admin token>` in the client.
See the [MCP integration guide ](https://fcb-docs.aiuo.net/en/guide/mcp ).
2026-07-11 23:00:24 +08:00
## Simple, yet capable
<table>
<tr>
<td width="33%" valign="top"><b>Share instantly</b><br /><sub>Files and text in one flow, with drag, paste, batch, and chunked uploads.</sub></td>
<td width="33%" valign="top"><b>Expire on your terms</b><br /><sub>Expire by time or retrieval count, keep forever, and clean up automatically.</sub></td>
<td width="33%" valign="top"><b>Own your data</b><br /><sub>Local, S3, OneDrive, WebDAV, and OpenDAL storage on infrastructure you control.</sub></td>
</tr>
</table>
## From sharing to administration
<table>
<tr>
2026-07-24 16:34:22 +08:00
<td width="50%"><img src="./.github/images/readme/send.webp" alt="File sharing screen" /></td>
<td width="50%"><img src="./.github/images/readme/dashboard.webp" alt="Admin dashboard" /></td>
2026-07-11 23:00:24 +08:00
</tr>
</table>
2026-07-24 16:34:22 +08:00
<table>
<tr>
<td width="33%"><img src="./.github/images/readme/login.webp" alt="Admin login" /></td>
<td width="33%"><img src="./.github/images/readme/files.webp" alt="File management" /></td>
<td width="33%"><img src="./.github/images/readme/settings.webp" alt="System settings" /></td>
</tr>
</table>
2026-07-11 23:00:24 +08:00
2025-01-26 10:57:46 +08:00
<div align="center">
2026-07-11 23:00:24 +08:00
`FastAPI` `Vue 3` `SQLite` `Docker` `S3` `WebDAV` `Dark Mode`
2026-07-11 22:48:52 +08:00
</div>
2026-07-11 23:00:24 +08:00
## Learn more
2026-07-11 22:48:52 +08:00
2026-07-11 23:00:24 +08:00
- [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
2025-01-26 10:57:46 +08:00
2026-07-11 22:48:52 +08:00
## Contributing
2025-01-26 10:57:46 +08:00
2026-07-11 23:00:24 +08:00
[Issues ](https://github.com/vastsa/FileCodeBox/issues/new/choose ) and pull requests are welcome. FileCodeBox is released under [LGPL-3.0 ](./LICENSE ).
2025-01-26 10:57:46 +08:00
2026-07-12 00:08:34 +08:00
## 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.
2025-01-26 10:57:46 +08:00
<div align="center">
2026-01-25 14:12:20 +08:00
2026-07-11 23:00:24 +08:00
**If FileCodeBox helps you, consider leaving a Star.**
2026-01-25 14:12:20 +08:00
</div>