Skip to main content

Configuration

Default configuration keys for @quik/storage. See Config Keys and Environment Variables for the full generated table.

  • storage.engine selects the default engine name (local by default).
  • storage.local.* configures the local filesystem engine: enabled, upload (temp folder), destination, publicUrl.
  • storage.local.signed.* configures signed local storage URLs: secret (required to sign/verify tokens), upload/download (expiration in seconds, default 60).
  • storage.local.http.basePath (default /storage/local) is only used to build the URL string returned by the signed-URL helpers below — this package does not register any HTTP routes itself.
  • storage.s3.* configures the S3 engine: enabled, region, endpoint, pathStyleUrl, accessKeyId, secretAccessKey, bucket.
  • storage.s3.signed.* configures S3 signed URL expiration: upload/download (seconds, default 60).

Signed local storage URLs​

Generating a signed local storage URL (PresignedLocalURLEntity.getUploadURL/getDownloadURL, or QLocalStorageEngine.getSignedUploadURL/getSignedDownloadURL) throws StorageLocalSigningSecretMissingError unless storage.local.signed.secret is set. There is no default secret — it must be configured explicitly per environment.