Generic

Overview

Upload any file to Fly Registry and organize it by package name and version. Generic storage works with any file type – you choose a package name and version, and Fly stores your files under that path.

How It Works

Generic storage organizes files by package name and version:

Concept	What it is	Example
Package name	A name that groups related files	`my-app`, `ml-models`, `config-bundle`
Version	An identifier for a specific set of files	`1.0.0`, `latest`, `nightly-2025-03-18`
Files	One or more files stored under that package and version	`app.dmg`, `checksums.txt`

A file’s full path in Fly Registry is:

<your-fly-subdomain>.jfrog.io/artifactory/api/generic/<name>/<version>/<filename>

Use generic storage for anything that doesn’t go through a package manager: release binaries, build outputs, signed archives, configuration bundles, or any file your team needs to share and version.

Parameters

Parameter	Required	Description
`--name`	Yes	Package name to group your files under
`--version`	Yes	Version label for this set of files
`--exclude`	No	Wildcard pattern to skip matching files (can be used multiple times)
`--output-dir`	No	Directory to save downloaded files to (download only)

Files are listed at the end of the command. You can specify one or more file paths, or use wildcards like *.zip.

Upload Package

With Fly App

Ask your coding agent:

“Upload my release files to Fly under my-app version 1.0.0”

Or use the terminal directly – Fly App handles authentication automatically:

fly upload --name my-app --version 1.0.0 dist/app.dmg

Upload multiple files or use wildcards:

# Multiple files or wildcards
fly upload --name my-app --version 1.0.0 release/*.zip build/**/*.bin

# Skip specific files
fly upload --name my-app --version 1.0.0 --exclude '*.log' release/*

With an Access Token

To upload without Fly App authentication, use an access token with cURL:

curl -u <your-fly-username>:<your-fly-token> \
  -T my-file.bin \
  https://<your-fly-subdomain>.jfrog.io/artifactory/api/generic/my-app/1.0.0/my-file.bin

Download Package

With Fly App

Ask your coding agent:

“Download my-app version 1.0.0 from Fly”

Or use the terminal directly:

fly download --name my-app --version 1.0.0 app.dmg

Download multiple files to a specific folder:

fly download --name my-app --version 1.0.0 --output-dir ./release file1.zip file2.tar.gz

Note

Unlike upload, download expects exact filenames – glob patterns are not expanded.

With an Access Token

To download without Fly App authentication, use an access token with cURL:

curl -u <your-fly-username>:<your-fly-token> \
  -O https://<your-fly-subdomain>.jfrog.io/artifactory/api/generic/my-app/1.0.0/my-file.bin

Upload Package with CI

Ask your coding agent: “Add my app (generic package) version 1.0.0 to my workflow” – Fly will configure it for you.

1. Add permissions (top level, after on:):

permissions:
  contents: read
  id-token: write

2. Add Fly Action and upload step (in your job’s steps:):

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

- uses: jfrog/fly-action/upload@v1       # Upload artifacts
  with:
    name: my-app
    version: '1.0.0'
    files: |
      dist/*.zip
      dist/*.tar.gz

Download Package with CI

1. Add permissions (top level, after on:):

permissions:
  contents: read
  id-token: write

2. Add Fly Action and download step (in your job’s steps:):

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

- uses: jfrog/fly-action/download@v1     # Download artifacts
  with:
    name: my-app
    version: '1.0.0'
    files: |
      installer.dmg
      checksums.txt
    exclude: |                             # Skip files matching pattern
      *.log
    output-dir: ./release

GitHub Action Example

A complete workflow with both upload and download:

name: Release Artifacts

on:
  push:
    tags: ['v*']

permissions:
  contents: read
  id-token: write                        # Authentication

jobs:
  release:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

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

      - uses: jfrog/fly-action/upload@v1       # Upload artifacts
        with:
          name: my-app
          version: ${{ github.ref_name }}
          files: |
            dist/*.zip
            dist/*.tar.gz

      - uses: jfrog/fly-action/download@v1     # Download artifacts
        with:
          name: my-app
          version: ${{ github.ref_name }}
          files: installer.dmg
          output-dir: ./release

Verify Results

After each upload or download, you can verify your files were transferred successfully. The action outputs a summary for each file:

- name: Upload artifacts
  id: upload
  uses: jfrog/fly-action/upload@v1
  with:
    name: my-app
    version: '1.0.0'
    files: dist/*.zip

- name: Check results
  run: echo '${{ steps.upload.outputs.results }}'
  # [{"name":"app.zip","status":"success","message":"..."}]

Back to Package Managers →