Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brightnode.cloud/llms.txt

Use this file to discover all available pages before exploring further.

​
Choose your transfer method

Brightnode supports four different file transfer methods, each optimized for specific use cases:
MethodBest forSetup requiredFile size limit
SCPStandard file operationsSSH configurationAny size
rsyncLarge datasets, syncingSSH + rsync installationAny size
Cloud syncBackup, multi-environment sharingCloud provider setupProvider dependent

​
SCP

A reliable, standard method that works over SSH. Ideal for users comfortable with command-line tools who need to transfer both individual files and directories. To configure your Bnode for SSH access, see the (SSH setup guide).

​
rsync

The most powerful option, featuring incremental transfers, compression, and detailed progress reporting. Essential for large datasets, regular synchronization, and preserving file attributes. To set up rsync:
  • Configure SSH access (same as for SCP).
  • Install rsync on both machines: apt install rsync
  • Ensure your local machine is running a Linux or WSL environment.

​
Cloud sync

Direct synchronization with cloud storage providers like AWS S3, Google Cloud Storage, or Dropbox. Best for creating backups or sharing files across multiple environments. To learn more, see the cloud sync configuration guide.

​
Transfer with SCP

SCP provides reliable file transfer over SSH connections. Use this method when you need standard command-line file operations.

​
Basic syntax

The general format for SCP commands (replace 43201 and 194.26.196.6 with your Bnode’s port and IP): 
scp -P 43201 -i ~/.ssh/id_ed25519 /local/file/path root@194.26.196.6:/destination/file/path
If your private key is stored elsewhere or you’re using Windows Command Prompt, update the key path accordingly. For quick one-time setups, consider password-based SSH.

​
Send files to your Bnode

Transfer a single file: 
scp -P 43201 -i ~/.ssh/id_ed25519 ~/documents/example.txt root@194.26.196.6:/root/example.txt
Transfer a directory (use -r for recursive copying): 
scp -r -P 43201 -i ~/.ssh/id_ed25519 ~/documents/example_dir root@194.26.196.6:/root/example_dir

​
Download files from your Bnode

Simply reverse the source and destination: 
scp -P 43201 -i ~/.ssh/id_ed25519 root@194.26.196.6:/root/example.txt ~/documents/example.txt

​
Transfer with rsync

rsync offers advanced synchronization features and is the best choice for large datasets or regular backup operations.
rsync requires a Linux environment or WSL on Windows.

​
Basic syntax

rsync -e "ssh -p 43201" /source/file/path root@194.26.196.6:/destination/file/path

​
Essential flags

  • -a (archive) - Preserves permissions, timestamps, and attributes (essential for directories)
  • -v (verbose) - Shows detailed transfer information
  • -z (compress) - Compresses data during transfer (saves bandwidth, uses more CPU)
  • -p (progress) - Displays transfer progress
  • -d (delete) - Removes files from destination that don’t exist in source

​
Send files to your Bnode

Transfer with progress and compression: 
rsync -avz -e "ssh -p 43201" ~/documents/example.txt root@194.26.196.6:/root/example.txt

​
Download from your Bnode

rsync -avz -e "ssh -p 43201" root@194.26.196.6:/root/example.txt ~/documents/example.txt

​
Directory synchronization

Transfer directory contents only (note the trailing slash): 
rsync -avz -e "ssh -p 43201" ~/documents/example_dir/ root@194.26.196.6:/root/example_dir/
Transfer the directory itself (no trailing slash): 
rsync -avz -e "ssh -p 43201" ~/documents/example_dir root@194.26.196.6:/root/

​
Incremental transfers

rsync’s key advantage is intelligent synchronization. Files that already exist at the destination aren’t transferred again: First transfer (full copy): 
rsync -avz -e "ssh -p 43201" ~/documents/example.txt root@194.26.196.6:/root/example.txt
sending incremental file list
example.txt
             119 100%    0.00kB/s    0:00:00 (xfr#1, to-chk=0/1)

sent 243 bytes  received 35 bytes  185.33 bytes/sec
total size is 119  speedup is 0.43
Second transfer (minimal data): 
rsync -avz -e "ssh -p 43201" ~/documents/example.txt root@194.26.196.6:/root/example.txt
sending incremental file list

sent 120 bytes  received 12 bytes  88.00 bytes/sec
total size is 119  speedup is 0.90

​
Sync with cloud storage

Connect your Bnode storage directly to cloud providers for seamless backup and synchronization. To set up cloud sync:
  1. Navigate to your My Bnodes page
  2. Click the Cloud Sync option for your Bnode
  3. Follow the provider-specific configuration steps
For detailed setup instructions with AWS S3, Google Cloud Storage, Azure, Backblaze, and Dropbox, see the cloud sync configuration guide.

​
Transfer with Google Drive

You can also use these Colab notebooks to transfer files between Bnodes and Google Drive:

​
Troubleshooting

Here are some common issues and possible fixes: Connection refused errors:
  • Verify SSH is properly configured on your Bnode.
  • Check that the correct port and IP address are being used.
  • Ensure port 22 is exposed in your Bnode configuration.
Permission denied:
  • Confirm your SSH key is correctly specified with -i
  • Verify the key has appropriate permissions (chmod 600 ~/.ssh/id_ed25519)
  • Try password-based authentication for quick tests.
Large file transfers timing out:
  • Use rsync instead of SCP for better reliability.
  • Add the -z flag to compress data during transfer.
  • Consider splitting very large files before transfer.