Distribution

Overview

Get a release into your customers’ hands. You shipped a version you’re confident in – distribution is how you hand it to the people outside your team who need it.

Pick the version you want to share, make it public, and Fly gives you a link or command your customers use to get it directly. Every download is tracked, and you can revoke access the moment you’re done.

Distribute

Distributing an artifact version makes it available to your customers. Once a version is publicly available, anyone you share the link or pull command with can download or pull it directly, without a token.

Distribution never changes your private registry. Your internal artifacts stay private – distribution takes the specific version you choose and makes that copy available to your customers. You decide which versions to share, and you can revoke access at any time.

Distribution currently supports the following package types:

How to Distribute

From Your Coding Agent

Simply prompt your agent to distribute your version:

“Distribute my-app version 2.1.0 publicly”

Fly makes the version public and hands back the download URL or docker pull command to share with your customers.

From Fly Web

  1. Find the artifact or release you want to share – from the Artifacts page or a Release page
  2. Open the actions menu and select Manage Distribution
  3. Toggle distribution on

Fly generates the public download URL (for generic artifacts) or pull command (for Docker images) right there for you to copy and share.

From CI

Add the distribute step after you upload or push, so every release you publish is shared automatically.

Generic artifact:

- uses: jfrog/fly-action@v1                  # Setup Fly

- uses: jfrog/fly-action/distribute@v1       # Distribute publicly
  with:
    name: my-app
    version: '1.0.0'
    type: generic

Docker image:

- uses: jfrog/fly-action/distribute@v1       # Distribute publicly
  with:
    name: myorg/my-image
    version: '1.0.0'
    type: docker

How to Pull

Your customers retrieve the version directly, with no authentication. The command depends on the package type.

Generic Artifact

Customers download any file in the version from its public URL:

https://<your-fly-subdomain>.jfrog.io/public/generic/<name>/<version>/<file>

For example:

curl -O https://acme.jfrog.io/public/generic/my-app/2.1.0/my-app.dmg

Docker Image

Customers pull the image anonymously, with no docker login:

docker pull <your-fly-subdomain>.jfrog.io/docker-public/<image>:<tag>

For example:

docker pull acme.jfrog.io/docker-public/myorg/my-image:1.0.0

Track Distribution

Keep track of what you’ve shared – how many times each of your releases has been downloaded, and what’s currently public. Check in anytime by asking your coding agent, or open Fly Web to view and manage it directly:

  • Public badge – Distributed versions display a Public badge on the artifact version and on the release it belongs to. Hover the badge to see who distributed the version and when.
  • Download activity – Expand a distributed version on the Artifacts page to see its public activity:
    • Download count – how many times the version was downloaded or pulled publicly, updated in real time.
    • Copy link – copy its public download URL or pull command to share with customers.

Want to keep tabs on what’s public? Ask your coding agent to notify you whenever a new distribution happens – and you’re all set. Read more in Notifications →.

Remove Distribution

Stop sharing a version whenever you need to. When you remove its distribution, the version becomes private again immediately – the public download URL and pull command stop working, and your customers can no longer access it.

Removing distribution only turns off public access. The artifact itself stays in your private registry, so you can distribute the same version again later.

To remove it, ask your coding agent:

“Revoke public access to my-app version 2.1.0”

Or toggle it off in Fly Web:

  1. Find the distributed artifact or release – from the Artifacts page or a Release page
  2. Open the actions menu and select Manage Distribution
  3. Toggle distribution off
Note

If you delete the original artifact, Fly removes the public copy and all distribution data automatically.

Next Steps