Files
FileCodeBox/docs/en/guide/getting-started.md

2.7 KiB

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 run -d --restart unless-stopped \
  -p 12345:12345 \
  -v fcb-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: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
APP_ENV production (Docker) Runtime environment; production disables HTTP access logs by default
LOG_LEVEL warning (Docker) debug, info, warning, or error
ACCESS_LOG false (production) Enable HTTP access logs; set to true when debugging requests

Production deployments output only warning, error, and other key events by default. Docker retains at most three 10 MB log files.

Manual Deployment

  1. Clone the repository
git clone https://github.com/vastsa/FileCodeBox.git
  1. Install dependencies
cd FileCodeBox
pip install -r requirements.txt
  1. 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