File Upload and Processing Limits

Defines the file size, scan time, and unpacking limits for uploads to Stairwell via API or Forwarder.

Upload Size Limits

Maximum file size: 512 MB per file

Stairwell enforces a 512 MB limit on individual file uploads and processing. Files larger than this will be rejected at upload.


Scan Duration and Throughput

Analysis must complete within a 15-minute scan window. Files approaching the 512 MB limit may experience timeouts depending on:

  • File type complexity
  • Archive depth and structure
  • Current system load

If analysis cannot be completed within that time, the process stops automatically.


Archive Unpacking Limits

Archives (ZIP, TAR, etc.) are unpacked and analyzed recursively, but the same 512 MB limit applies to:

  • The archive file itself
  • Each individual file extracted from the archive

Large nested archives or archives containing many files may hit processing limits depending on total unpacked size and structure.


Summary

CategoryPractical Limit
File upload (API / Forwarder)512 MB analyzed
Archive unpacking512 MB per archive & per extracted file
Scan duration15 minutes per file