Download system

Insights about the Agents download system
Written by Philipp
Updated 3 weeks ago
Downloads differ based on the specific title and ecosystem

Steam

China: Agents located in China will automatically select Steam China CDN servers, this can be overriden only through your config.toml

Steam based downloads are handled automatically with no additional setup required.

The Agent will automatically select a CDN server based upon Steams preferences in your region. The exact sorting depends on the overall load of the individual CDN servers.

It will always prefer CDN servers that are under lower load. Should the Agent encounter issues with individual CDN servers, it will be excluded from downloads. The list of available CDN servers are refreshed every 24 hours or if there are no download servers eligible for download (due to blacklisting).

Download Pipeline

By default, the agent will process downloads like a normal Steam Client, eg. select multiple Steam CDN servers for download processing and the download as fast as possible. Chunks are cached in memory until they are written to disk.

This behavior allows for extremely fast downloads, but may not be suitable for every situation.
In case of memory issues, the memory buffer for downloads can be adjusted through `disable_buffered_download`. The overall CPU/Net I/O consumption can be controlled by limiting parallel downloads through `download_batch_size`.
For details revise your config.toml under reference from available configuration parameters.

Did this answer your question?