Turbo mode for large downloads
Turbo mode delivers large downloads straight from the storage that holds them. It is on by default for every account, on every plan, and needs no change to your package tools.
What Turbo mode does
Section titled “What Turbo mode does”When a developer or a build asks for a big payload, such as a large package file, a container image layer, or a Helm chart, Ravenstash checks access as it does for every download. It then lets the tool fetch that one file directly from storage instead of from the Ravenstash host the tool is configured with.
- Faster large downloads. Turbo mode can reach up to 1 gigabit per second. The gain shows on fast connections, such as CI runners in a data center. On a slower link the link itself is the limit and you may see no difference. Ravenstash does not guarantee a speed for an individual download.
- Access is still checked for every download. Storage only serves a file that Ravenstash has just authorized. What the tool receives works for that one file, for a short time, and contains no Ravenstash credential.
- Nothing to configure. Repository URLs, credentials, and
rvscommands stay the same.
The alternative is standard delivery: the file comes from the Ravenstash host itself, through the delivery network.
Which downloads use it
Section titled “Which downloads use it”Turbo mode applies to large downloads only. Ravenstash decides which downloads are large enough to benefit; you do not set a size.
| Download | Delivery |
|---|---|
| A large package file, container image layer, or Helm chart, downloaded in full | Turbo mode |
| Smaller files | Standard delivery |
| Resumed and partial downloads | Standard delivery |
| Package indexes, metadata, checksums, and image manifests | Standard delivery |
The same rules apply to private repositories, private mirrors, and files a repository serves from another repository or a private mirror connected as an upstream.
Turbo mode works with Ravenstash-managed storage. For storage your organization owns, an organization administrator must also allow direct downloads for that storage in the organization’s storage settings. Until then, files kept there use standard delivery.
Turbo mode does not change how artifact reads are counted. A large download counts as one artifact read with either kind of delivery.
Turn Turbo mode off
Section titled “Turn Turbo mode off”You might turn Turbo mode off when:
- your network, proxy, or firewall only allows Ravenstash hosts and you cannot add the storage hosts;
- a tool fails on large downloads and you cannot change its settings; or
- you want every download to come from the Ravenstash hosts you already use.
The control is named Artifacts delivery Turbo mode. It is in the Danger zone:
- Organization: an organization administrator opens the organization’s settings, then Danger zone.
- Personal account: open your account settings, then Danger zone.
There is one setting per organization or personal account. It covers every repository, upstream, and private mirror of that account; there is no separate setting for a namespace, repository, or mirror.
A change applies to the next download. With Turbo mode off, every download uses standard delivery, whatever the tool. You can turn it back on at any time.
Network requirements
Section titled “Network requirements”With Turbo mode, a tool downloads large files over HTTPS (port 443) from a storage host as well as from the Ravenstash hosts. If your network only allows listed hosts, also allow these:
- Ravenstash Turbo compatibility host:
art-turbo-compat.rvsta.sh. Some tools pass through it on the way to storage. If you already allow every host ending in.rvsta.sh, it is covered. - Ravenstash-managed storage: hosts ending in
.r2.cloudflarestorage.com. Storage in the European Union uses hosts ending in.eu.r2.cloudflarestorage.com, which the same rule covers. - Your organization’s Cloudflare R2 storage: the same hosts.
- Your organization’s OVH Object Storage: hosts ending in
.io.cloud.ovh.netor.cloud.ovh.us, depending on the storage region.
Match these names by their ending. A storage host has several name levels
before it, so a pattern that covers only one level, such as a single *, may
not match.
Keep the Ravenstash hosts allowed too: every download starts there. If the storage hosts cannot be allowed, turn Turbo mode off. Ravenstash cannot see that a network blocked a storage host, so these downloads do not switch to standard delivery by themselves.
Compatibility
Section titled “Compatibility”Last tested: October 9, 2026.
Ravenstash ran real downloads of large files with the tools and versions below. Each one is in one of three states:
- Works with Turbo mode. Nothing to do.
- Uses standard delivery automatically. Ravenstash serves the download through standard delivery for you. Nothing to do.
- Needs a change on your side. Large downloads fail until you change a client setting, allow the storage hosts, or turn Turbo mode off.
A range gives the oldest and the newest release that ran. Every uv release in its range ran, and every pip release except 20.0; for other tools, not every release in between was run. Releases newer than the range were not tested. Releases older than the range that cannot use Turbo mode use standard delivery automatically.
Tools and versions that are not listed are also sent through Turbo mode. If one of them has trouble with large downloads, turn Turbo mode off.
Python
Section titled “Python”| Tool | Versions tested | Result |
|---|---|---|
| pip | 6.0 to 26.2.1 | Works with Turbo mode |
| uv | 0.1.0 to 0.12.24 | Works with Turbo mode |
| Poetry | 1.0.0 to 2.5.1 | Works with Turbo mode |
| PDM | 2.0.0 to 2.29.2 | Works with Turbo mode |
| pixi | 0.81.0 | Works with Turbo mode |
| pipenv, pip-tools, Hatch | The newest release on the test date | Works with Turbo mode. They download through pip or uv. |
pip, Poetry, or PDM 2.12.4 and earlier, with a .netrc file that has a default entry |
pip 9.0.0 to 26.2.1, Poetry 1.1.11 to 2.5.1, PDM up to 2.12.4 | Needs a change on your side. See what to change. |
JavaScript
Section titled “JavaScript”| Tool | Versions tested | Result |
|---|---|---|
| npm | 5.0.0 to 12.2.0 | Works with Turbo mode |
| pnpm | 3.3.2 to 12.11.1 | Works with Turbo mode |
| Yarn 1 | 1.0.0 to 1.22.22 | Works with Turbo mode |
| Yarn 2, 3, and 4 | Up to 4.18.1 | Works with Turbo mode |
| Bun | 1.0.3 to 1.4.2 | Works with Turbo mode |
| Bun | 1.0.0 to 1.0.2 | Uses standard delivery automatically |
| Deno | 1.44.0 to 2.9.6 | Works with Turbo mode |
Maven and other JVM tools
Section titled “Maven and other JVM tools”| Tool | Versions tested | Result |
|---|---|---|
| Maven | 3.0.5 to 3.10.0, and 4.0.0-rc-1 to 4.0.0-rc-7 | Works with Turbo mode |
Maven before 3.10.0 with credentials in <httpHeaders> |
3.0.5 to 3.9.16 | Uses standard delivery automatically |
| Gradle | 5.6 to 9.8.1 | Works with Turbo mode |
| sbt | 1.4.9 to 2.0.10 | Works with Turbo mode |
| Coursier | 2.0.0 to 2.1.26 | Works with Turbo mode |
Coursier with pass-on-redirect set to true |
2.0.0 to 2.1.26 | Needs a change on your side. See what to change. |
| Apache Ivy | 2.4.0 to 2.6.0 | Works with Turbo mode |
| Leiningen | 2.13.0 | Works with Turbo mode |
Maven 3.10.0 or later is recommended. With its default settings, Maven 3.10.0 works with Turbo mode whichever way its credentials are set.
Container images and Helm charts
Section titled “Container images and Helm charts”Every container and Helm tool that was tested works with Turbo mode.
| Tool | Versions tested |
|---|---|
| Docker Engine | 19.03.15 to 29.9.0 |
containerd, including through ctr, nerdctl, and crictl |
1.6.39 to 2.4.1 |
| BuildKit | 0.12.5 and 0.34.0 |
| Podman | 3.4.7 to 5.8.7 |
| Buildah | 1.23.1 to 1.43.4 |
| Skopeo | 1.1.1 to 1.22.3 |
| Crane | 0.1.0 to 0.22.1 |
| kaniko | 1.24.0 |
| Jib (Maven plugin) | 1.4.0 to 3.5.2 |
| ORAS | 1.0.1 to 1.3.4 |
| Helm | 3.8.0 to 3.22.0, and 4.0.0 to 4.3.0 |
| regctl | 0.4.8 to 0.11.6 |
Command line and scripts
Section titled “Command line and scripts”| Tool | Versions tested | Result |
|---|---|---|
curl with -L |
7.58.0 to 8.22.0 | Works with Turbo mode |
PowerShell Invoke-WebRequest |
6.0.2 to 7.5.0 | Works with Turbo mode |
Python requests |
2.3.0 to 2.34.2 | Works with Turbo mode |
Python httpx |
0.15.5 to 0.28 | Works with Turbo mode |
Go net/http |
1.7.6 to 1.27.2 | Works with Turbo mode |
Node.js built-in fetch |
18.20.8 to 26.11.1 | Works with Turbo mode |
| axios | 0.21.1 to 1.20.0 | Works with Turbo mode |
| OkHttp | 3.14.9 to 5.5.0 | Works with Turbo mode |
| wget | 1.14 to 1.25.0 | Uses standard delivery automatically |
| aria2 | 1.37.0 | Uses standard delivery automatically |
Other tools that send a hand-set Authorization header to every host |
— | Uses standard delivery automatically |
curl with --location-trusted, or a similar “keep credentials on redirect” option |
8.22.0 | Needs a change on your side. See what to change. |
A script must follow redirects to download a large file. curl needs
--location (-L); httpx 0.20 and later needs follow_redirects=True.
Repository managers in front of Ravenstash
Section titled “Repository managers in front of Ravenstash”| Tool | Versions tested | Result |
|---|---|---|
| Sonatype Nexus Repository OSS | 3.76.1 | Works with Turbo mode |
| JFrog Artifactory OSS | 7.161.26 | Works with Turbo mode |
| devpi | 6.20.3 | Works with Turbo mode |
| Verdaccio | 4.13.2, 5.33.0, and 6.10.5 | Works with Turbo mode |
| zot | 2.1.22 | Works with Turbo mode |
What to change on your side
Section titled “What to change on your side”| Situation | What to do |
|---|---|
A .netrc file has a default entry, and pip, Poetry, or PDM 2.12.4 or earlier reads it |
Replace the default entry with a machine entry that names the Ravenstash host, or turn Turbo mode off. |
curl runs with --location-trusted, or another tool has a “keep credentials on redirect” option turned on |
Remove the option; for curl, use --location. Or turn Turbo mode off. |
Coursier runs with pass-on-redirect=true |
Remove the setting, or turn Turbo mode off. |
| A network, proxy, or firewall only allows Ravenstash hosts | Allow the storage hosts, or turn Turbo mode off. |