upload

Transfer files between the browser and hosting: upload sends files, download retrieves them, and directories are returned as temporary TAR archives.

FilesVersion 1.2.7Stable
lil-terminal

Overview

upload turns the browser into a practical file bridge for hosts without SSH: send one or many files to the current directory or a chosen directory, replace deliberately with -f, and use download for the reverse path. Directory downloads are packed into a temporary TAR automatically, while PHP upload limits remain visible as hosting constraints rather than hidden application behavior.

Transfer files through the browser

Use upload and download for direct browser transfers; for deployments, combine them with archive commands so many files can move as one package.

Syntax

lil-terminal
upload [<dir>|<file> -f] [-raw]

Reference

upload

choose and upload files to the current directory

upload <dir>

upload files to <dir>

upload <dir> -f

upload files to <dir> and replace same-named files

upload <file> -f

upload one file to an exact path and replace the existing file

upload -raw

keep the exact Unicode name and spaces

Working with results

Names become portable ASCII by default: Cyrillic is transliterated, spaces become hyphens and unsupported characters get Unicode code identifiers. File extensions stay intact. Collisions receive -001, -002, etc.; use -raw for original names and -f only when you intend to replace files.

Safety and limits

Choose at most 20 files per operation. PHP, proxy and hosting limits can reject oversized uploads. The transfer uses a short-lived session token; the documentation preview does not send real files.

Interactive sandbox preview

Run the prepared examples directly on the page. Their results are prebuilt and shown in the browser; no terminal command is executed on the server.

Choose and upload files to the current directory

Install and manage

Install the current compatible version. Choose Base for the complete feature set or Minimum for the reduced package; use upgrade to update a module that is already installed.

Base and Minimum are two packages of the same current module release, not separate command versions.

Base package

Install the complete package with local command reference and every published mode.

install upload
Minimum package

Install the reduced package. Local reference is omitted; help <cmd> -i opens the current server reference.

install upload -m
Exact public version

Install exactly this published version.

install upload -v 1.2.7
Check or update

Ask upgrade to check compatibility and replace the installed block only when needed.

upgrade upload
Remove module

Remove the extension block while leaving the core and unrelated modules intact.

install upload -u

Examples

Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.

Choose and upload files to the current directory
upload
Browser file picker opens. No files are transferred in this preview.
Upload files to <dir>
upload \sandbox\tmp
Browser file picker opens. No files are transferred in this preview.
Upload files to <dir> and replace same-named files
upload \sandbox\tmp -f
Browser file picker opens. No files are transferred in this preview.
Upload one file to an exact path and replace the existing file
upload \sandbox\tmp\review.txt -f
Browser file picker opens. No files are transferred in this preview.
Keep the exact Unicode name and spaces
upload \sandbox\tmp -raw
Browser file picker opens. No files are transferred in this preview.
Keep the exact Unicode name and spaces
upload \sandbox\tmp -raw -f
Browser file picker opens. No files are transferred in this preview.
Handle a missing download target
upload -- -incoming
Browser file picker opens. No files are transferred in this preview.

File used in this example: sandbox/tmp/README.txt

The example uses a file or directory from the protected /sandbox/ documentation workspace.

lil-terminal sandbox temporary workspace

Commands in the public documentation use this directory for disposable copies,
archives, uploads and files created during examples. Review destructive commands
before running them and restore the sandbox from the release package when needed.

Related documentation

How are filesystem operations protected? →Why are large files or outputs limited? →

Current public release

v1.2.72026-10-31

Independent upload module

Upload is independent from download; updating a legacy combined package migrates download into a separate installed module.

# Version history