Skip to main content

signaloid-cli files download

Download a file from storage.

Synopsis​

signaloid-cli files download --path <path> [options]

Description​

Download a file from Signaloid cloud storage to your local machine. You can specify the output directory and filename, or use defaults.

Options​

OptionDescriptionDefault
--path <path>Remote file path (required)-
--out <dir>Output directory./downloads
--name <filename>Save as filenameLast path segment

Examples​

Download to Default Directory​

signaloid-cli files download --path datasets/data.csv

This downloads to ./downloads/data.csv.

Download to Specific Directory​

signaloid-cli files download \
  --path datasets/data.csv \
  --out ./local-data

Download with Custom Filename​

signaloid-cli files download \
  --path datasets/data.csv \
  --out ./local-data \
  --name input.csv

Download Multiple Files​

signaloid-cli files ls --path datasets/ | jq -r '.Files[].Path' | \
while read FILE_PATH; do
  signaloid-cli files download --path "$FILE_PATH" --out ./backup
done

Notes​

  • The output directory is created automatically if it does not exist
  • Files are overwritten if they already exist at the destination
  • Use --name to rename files during download
  • For large files, consider checking size first with signaloid-cli files stat

Troubleshooting​

Download Failures​

Problem: File download fails or times out.

Solutions:

  1. Verify the file exists: 
    signaloid-cli files stat --path datasets/data.csv
  2. Check network connectivity
  3. Ensure sufficient local disk space
  4. For large files, verify file size first: 
    signaloid-cli files stat --path datasets/data.csv | jq -r '.Size'

Permission Errors​

Problem: Cannot write to output directory.

Solutions:

  1. Verify directory permissions
  2. Create the directory manually first
  3. Try a different output directory where you have write access

See Also​

Last updated on