ar-io/ARIO Deploy
Deploy static sites to Arweave and update ArNS records. Perfect for PR previews and production deployments.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jun 12, 2026
- License
- MIT
Pinned Snippet
uses: ar-io/ar-io-deploy@adb027f069a18ff472d657826c620a4ca4f08176 # v1.0.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| deploy-key | Upload key (pays for the upload): Arweave JWK wallet (base64-encoded or JSON string), or raw private key for Ethereum/Polygon/KYVE/Solana signers | yes | — |
| arns-key | ArNS authority key: base58-encoded Solana secret key that controls the ArNS name and signs the record update. Separate from the upload key. | yes | — |
| arns-name | The ArNS name to update (e.g., "myapp" for myapp.turbo-gateway.com) | yes | — |
| undername | The undername to use. Use "@" for base name, or a custom value for undernames (e.g., "docs" for docs_myapp.turbo-gateway.com) | no | @ |
| deploy-folder | Path to the folder containing built static files to deploy | no | ./dist |
| deploy-file | Path to a single file to deploy (alternative to deploy-folder) | no | — |
| ttl-seconds | TTL in seconds for the ANT record (60-86400) | no | 3600 |
| sig-type | Signer type for the upload key that pays for the upload (arweave, ethereum, polygon, kyve, solana). | no | arweave |
| cluster | Solana cluster for ArNS updates (mainnet or devnet) | no | mainnet |
| rpc-url | Optional Solana RPC URL override for ArNS updates | no | — |
| on-demand | Enable on-demand payment with specified token (ario or base-eth) | no | — |
| max-token-amount | Maximum token amount for on-demand payment (used with on-demand) | no | — |
| uploader | Custom Turbo upload service base URL (defaults to the ArDrive production endpoint). | no | — |
| preview | Enable preview mode: auto-generates undername from PR number and posts a comment with the preview URL | no | false |
| auto-undername | Automatically generate undername from PR number or branch name (use preview for full PR preview functionality) | no | false |
| github-token | GitHub token for posting PR comments (required when preview is enabled) | no | — |
| no-dedupe | Disable deduplication (do not cache or reuse previous uploads). By default, ario-deploy caches your deployment log to prevent uploading duplicate (unchanged) files. | no | false |
| dedupe-cache-max-entries | Maximum number of entries to keep in the dedupe cache (LRU). Default is 10000. | no | — |
Outputs
| name | description |
|---|---|
| tx-id | The Arweave transaction ID of the uploaded content |
| deployment-url | The full URL where the deployment is accessible |
| undername-used | The undername that was used for the deployment |