Skip to main content
The dataerai command-line client lets you authenticate and manage assets — download, upload, and metadata — from a terminal or a script. It’s ideal for large or bulk transfers, pipelines, and headless environments like HPC clusters. The same binary also powers the transfers behind the desktop app.

​
Install

Build the binary from the cli/ directory: 
make build      # produces ./dataerai
make install    # installs to /usr/local/bin/dataerai
Make sure dataerai is on your PATH.

​
Commands

dataerai <command> [flags]

Commands:
  auth      Manage authentication credentials
  download  Download asset files to a local directory
  upload    Upload a file and create/upsert an asset
  metadata  Get or update asset metadata fields
See Authenticate and Commands.

​
Point the CLI at your server

The CLI talks to a specific DataErai deployment. Set it with the --server flag or the DATAERAI_SERVER environment variable, using your deployment’s URL: 
export DATAERAI_SERVER="https://<your-server>"
The server URL saved at dataerai auth login takes precedence over DATAERAI_SERVER, so once you log in you usually don’t need to pass --server again.

​
Credentials

After you log in, credentials are stored locally in ~/.dataerai/credentials.json (your access and refresh tokens, expiry, email, and server URL).
Treat ~/.dataerai/credentials.json like any other secret — it grants access to your DataErai account.

​
Next steps

Authenticate

Log in from a browser or with a device code.

Commands

Upload, download, and manage metadata.