Skip to main content
The SDK is configured via the config.json file located in the root of your nocloud resource folder. The default configuration is preconfigured with secure defaults and sensible limits—you can adjust these values to fit your needs.
The $schema property enables autocomplete and validation in editors like VS Code.

​
Logging

​
logging.enabled
boolean
default:"true"
Enable or disable logging output.
​
logging.level
string
default:"info"
The minimum log level to output.
LevelDescription
debugVerbose debugging information
infoGeneral operational messages
warnWarning messages
errorError messages only

​
Storage

​
storage.enable_client_uploads
boolean
default:"true"
Whether clients can trigger uploads from their game client or nui.
​
storage.max_file_size_mb
number
default:"50"
Maximum allowed file size in megabytes. Files exceeding this limit will be rejected.
​
storage.allowed_file_types
string[]
An array of MIME types permitted for upload. Any file type not in this list will be rejected.
CategoryMIME Types
Imagesimage/jpeg, image/png, image/gif, image/webp, image/svg+xml
Videovideo/mp4, video/webm
Audioaudio/mpeg, audio/wav
Documentstext/plain

​
Rate Limiting

Per-client rate limiting prevents abuse by restricting how many uploads each client can make within a time window.
​
storage.rate_limit.enabled
boolean
default:"true"
Enable or disable rate limiting.
​
storage.rate_limit.window_ms
number
default:"60000"
The time window in milliseconds for rate limit tracking.
ValueDuration
600001 minute
3000005 minutes
36000001 hour
​
storage.rate_limit.max_requests
number
default:"10"
Maximum number of upload requests allowed per client within the time window.
​
storage.rate_limit.client_identifier_extractor
string
default:"ip:license"
Defines how clients are uniquely identified for rate limiting. This is a colon-separated list of identifiers.
IdentifierDescription
ipClient’s IP address
licenseRockstar license identifier
steamSteam ID (if available)
discordDiscord ID (if available)
fivemFiveM account ID
Examples:
  • ip:license — Combines IP and license (default)
  • license — License only
  • ip:license:steam — Multiple identifiers