Repolode
Submit
vastsa

vastsa/FileCodeBox

Self-hosted file and text sharing tool where uploads get a passcode to pick up, like collecting an express parcel.

Open-source alternative to:WeTransferSend Anywhere

View on GitHubWebsite
Stars
8,768
Forks
1,086
Open issues
25
Last commit
11 days ago

What is it?

FileCodeBox is a self-hosted web tool for sharing files and text anonymously. The sender uploads content and receives a passcode; the recipient enters that code to retrieve it, with no account required on either side.

Shared items can expire by time, by number of pickups, or be kept permanently, and expired content is cleaned up automatically. Storage can be local disk or external backends such as S3, OneDrive, WebDAV, or OpenDAL, so data stays on infrastructure the operator controls. The stack is FastAPI on the backend with a Vue 3 frontend, and it ships as a Docker image.

The project also exposes an MCP Streamable HTTP endpoint, so compatible AI clients can create text and file shares through the share_text and share_file tools. Access can be restricted with an admin token when guest uploads are disabled.

Key features

  • 01Share files and text with a passcode, no registration needed
  • 02Expiry by time, pickup count, or permanent retention
  • 03Local or remote storage including S3, WebDAV and OneDrive
  • 04Drag-and-drop, paste, batch and chunked uploads
  • 05Admin dashboard with file management and system settings
  • 06MCP endpoint for creating shares from AI clients

Use cases

  • Sending a file to someone without an account or a chat app
  • Sharing a snippet of text with a short code instead of a public link
  • Running a private file drop on your own server or NAS
  • Letting an AI assistant hand off generated files via a share code

Quick start

  1. 1

    Start FileCodeBox with Docker in 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.5
  2. 2

    Open http://localhost:12345 in your browser and complete the first-time setup

Things to know

  • Documentation and the default setup are primarily in Chinese, though an English readme exists.
  • Licensed under LGPL-3.0, which carries copyleft obligations for modified library code.

In collections

Self-hosted cloud storage and file sharingMCP serversSelf-hosted apps

Topics

#file-sharing#self-hosted#fastapi#vue#docker#anonymous#mcp#s3#filecodebox#python

FAQ

What is FileCodeBox?
Self-hosted file and text sharing tool where uploads get a passcode to pick up, like collecting an express parcel. FileCodeBox is a self-hosted web tool for sharing files and text anonymously. The sender uploads content and receives a passcode; the recipient enters that code to retrieve it, with no account required on either side.
Is FileCodeBox free to use? What license does it have?
FileCodeBox is open source under the LGPL-3.0 license. Check the license terms before using it in commercial products.
Is FileCodeBox still maintained?
Actively maintained. The last commit to FileCodeBox was on Oct 27, 2026.
What can I use FileCodeBox for?
Sending a file to someone without an account or a chat app Sharing a snippet of text with a short code instead of a public link Running a private file drop on your own server or NAS Letting an AI assistant hand off generated files via a share code
How do I install FileCodeBox?
Start FileCodeBox with Docker in 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.5 Open http://localhost:12345 in your browser and complete the first-time setup
Where can I get FileCodeBox?
The source code and installation instructions are on GitHub: https://github.com/vastsa/FileCodeBox

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects