Skip to content

Latest commit

 

History

History
98 lines (67 loc) · 4.12 KB

readme_en.md

File metadata and controls

98 lines (67 loc) · 4.12 KB
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 · Documentation · 简体中文

Release Docker Pulls Stars License


FileCodeBox

Start with one command

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.8.3 # 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://<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.

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

Contributing

Issues and pull requests are welcome. FileCodeBox is released under LGPL-3.0.

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.