Docs/CLI/upload

reel upload

Requires --agent

Upload forensic artifacts to an S3 evidence vault.

Upload commands generate artifacts, send them to S3, and delete local copies. This is the primary mechanism for scheduled evidence collection. For local exports, see reel export.


S3 Flags

All upload subcommands share these S3 configuration flags:

FlagDescription
--s3-bucketS3 bucket name (required)
--s3-regionAWS region
--s3-secret-nameKubernetes secret with AWS credentials

S3 configuration can also be set via pod annotations. See S3 Evidence Vault.

Subcommands

Every export subcommand has a matching upload counterpart with identical flags plus the S3 flags above.

CommandArtifact
upload sbomSoftware Bill of Materials
upload cbomCryptographic Bill of Materials
upload sarifSARIF security scan results
upload malwareMalware scan results
upload checkpointCRIU process state
upload layerFilesystem diff
upload frameCheckpoint + layer archive
upload memoryMemory dump (ELF core)
upload volatileRuntime state snapshot
upload metadataContainer metadata
upload filesContainer files
upload inventoryForensic file inventory

S3 Key Pattern

Artifacts are organized in S3 by date, type, and source:

{date}/{type}/{cluster}_{node}_{namespace}_{pod}_{container}_{timestamp}.{ext}