- add pyproject.toml with pytest config and dev dependency group (PEP 735) - add ruff (core correctness rules) + pre-commit hook - fix stored XSS: html.escape site config before index template injection, with regression tests - log previously swallowed cleanup exceptions in upload rollback paths - consolidate three duplicate path generators into build_file_path (also aligns chunk/presign date dirs to get_now() instead of local time) - drop redundant ip_limit sync in load_config (refresh_settings covers all limiters) - remove dead code (calculate_file_hash, commented-out block), two orphan guide docs, and stale .gitignore entries - add dependabot for pip, docker, and github-actions - bump starlette 1.3.1 -> 1.6.0 (no breaking API changes; verified with the full test suite plus an ASGI smoke test incl. Range downloads) - skip theme asset tests when themes/ is not built locally
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 · 简体中文
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.5.6 # x-release-please-version
Open http://localhost:12345 and complete first-run setup. Pin a version in production; latest tracks the newest stable release.
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
![]() |
![]() |
![]() |
![]() |
![]() |
FastAPI Vue 3 SQLite Docker S3 WebDAV Dark Mode
Learn more
- Getting started · deployment, setup, and upgrades
- Storage · local and object storage
- Security · rate limits, sessions, and access protection
- API reference · upload, retrieval, and administration
- Frontend source · the active 2024 theme
Related projects
If you enjoy self-hosted “box” tools, also check out this project from the same author:
BokeBox · Private AI Podcast Box
Drop in videos, links, or drafts, and get listen-worthy personal podcasts with custom host persona and voice.
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.




