Getting Started

Introduction

FileCodeBox is a simple and efficient file sharing tool that supports temporary file transfer, sharing, and management. This guide will help you quickly deploy and use FileCodeBox.

Features

• 🚀 Quick Deployment: Support Docker one-click deployment
• 🔒 Secure & Reliable: File access requires extraction code
• ⏱️ Time Control: Support setting file expiration time
• 📊 Download Limit: Can limit file download times
• 🖼️ File Preview: Support preview of images, videos, audio, and other formats
• 📱 Responsive Design: Perfect adaptation for mobile and desktop

Deployment Methods

Docker Deployment (Recommended)

docker run -d --restart unless-stopped \
  -p 12345:12345 \
  -v fcb-data:/app/data \
  --name filecodebox \
  lanol/filecodebox:latest

The named volume persists configuration and uploaded files across container upgrades.

Variable	Default	Description
HOST	0.0.0.0	Service listening address
PORT	12345	Service port
WORKERS	1	Worker count; keep one worker for SQLite deployments
LOG_LEVEL	info	debug, info, warning, or error

Manual Deployment

1. Clone the repository

git clone https://github.com/vastsa/FileCodeBox.git

2. Install dependencies

cd FileCodeBox
pip install -r requirements.txt

3. Start the service

python main.py

Usage

1. Access the System Open browser and visit http://localhost:12345

2. Upload Files

   • Click upload button or drag files to upload area
   • Set file expiration time and download limit
   • Get share link and extraction code

3. Download Files

   • Visit share link
   • Enter extraction code
   • Download file

4. Admin Panel

   • Open http://localhost:12345 on first run and complete setup
   • Visit http://localhost:12345/#/admin
   • Enter the admin password set during setup
   • Enter admin panel
   • View system information, files, activity records, and configuration

Next Steps

• Storage Configuration - Learn how to configure different storage methods
• Security Settings - Learn how to enhance system security
• API Documentation - Learn how to integrate through API