fastfilelink/ffl repository overview

⁠FastFileLink Docker Usage

This image packages the FastFileLink CLI (ffl). It can share a file (produces a link) and download a file from a link.

For the complete command usage, please see https://github.com/nuwainfo/ffl⁠

⁠Build

docker build -t ffl .

⁠Share a File (produce a link)

docker run --rm --network host \
  -v "$(pwd)/temp_docs:/data" \
  ffl /data/myfile.txt

Notes:

• The command prints a public HTTPS link. Keep the container running until the recipient downloads.
• --max-downloads 1 will stop after one download.
• You can set a custom port with --port <port>.
• --network host is not strictly required, but adding it can greatly improve the success rate of WebRTC connections. Otherwise, the transfer may fall back to Relay, which is slower.

Example with max downloads:

docker run --rm --network host \
  -v "$(pwd)/temp_docs:/data" \
  ffl --max-downloads 1 /data/myfile.txt

⁠Download a File (from a link)

docker run --rm --network host \
  -v "$(pwd)/temp_docs:/out" \
  ffl download "https://<link>" --output /out/downloaded.txt

⁠Full Local Test (share + download)

This runs a share container, grabs the link, then downloads using another container.

# Create a sample file
echo "hello" > temp_docs/sample.txt

# Start sharing (prints link)
docker run --rm --network host -v "$(pwd)/temp_docs:/data" ffl --max-downloads 1 /data/sample.txt

# In another terminal, download via container:
docker run --rm --network host -v "$(pwd)/temp_docs:/out" ffl download "https://<link>" --output /out/sample_downloaded.txt