Skip to main content
cover The Pinata CLI is a tool you can use alongside your account to upload and manage files through your terminal. It also provides access to Pinata’s Agents platform (beta), allowing you to create, manage, and interact with hosted agents directly from the command line. The source code can be found in the link below.

Source Code

​
Installation

If you are on Windows please use WSL when installing. If you get an error that it was not able to resolve the github host run git config --global --unset http.proxy

​
Install Script

The easiest way to install is to copy and paste this script into your terminal 
curl -fsSL https://cli.pinata.cloud/install | bash

​
Homebrew

If you are on MacOS and have homebrew installed you can run the command below to install the CLI 
brew install PinataCloud/ipfs-cli/ipfs-cli

​
Building from Source

To build and install from source make sure you have Go installed on your computer and the following command returns a version: 
go version
Then paste and run the following into your terminal: 
git clone https://github.com/PinataCloud/ipfs-cli && cd ipfs-cli && go install .

​
Linux Binary

As versions are released you can visit the Releases page and download the appropriate binary for your system, them move it into your bin folder. For example, this is how I install the CLI for my Raspberry Pi 
wget https://github.com/PinataCloud/ipfs-cli/releases/download/v0.1.0/ipfs-cli_Linux_arm64.tar.gz

tar -xzf ipfs-cli_Linux_arm64.tar.gz

sudo mv pinata /usr/bin

​
Authentication

With the CLI installed you will first need to authenticate it with your Pinata JWT. Run this command and follow the steps to setup the CLI! 
pinata auth

​
Configuration

Set a default IPFS network, can be either public or private. You can always change this at any time or override in individual commands. If none is set the default is public. 
NAME:
   pinata config - Configure Pinata CLI settings

USAGE:
   pinata config command [command options] [arguments...]

COMMANDS:
   network, net  Set default network (public or private)
   help, h       Shows a list of commands or help for one command

OPTIONS:
   --help, -h  show help

​
Next Steps

IPFS

Upload files, manage groups, gateways, keys, and swaps

Agents CLI

Manage your Pinata Agents from the terminal (beta)

​
Contact

If you have any questions please feel free to reach out to us! [email protected]