Documentation
/
Commands
/
remotes

remotes - Manage Cloud Storage
Connect and manage cloud storage providers

Manage connections to cloud storage providers like Google Drive, OneDrive, Amazon S3, and Backblaze B2.

Supported Providers
Google Drive
OneDrive
Amazon S3
Backblaze B2

Subcommands

remotes add - Add new cloud storage

Add a new cloud storage provider with provider-specific subcommands.

filefortress remotes add gdrive [--name "name"] [--reconfigure]
filefortress remotes add onedrive [--name "name"] [--reconfigure]
filefortress remotes add s3 [--non-interactive --access-key KEY --secret-key SECRET] [options]
filefortress remotes add backblaze [--non-interactive --key-id ID --application-key KEY] [options]

Supports: Google Drive, OneDrive, Amazon S3, and Backblaze B2.

All commands run in interactive mode by default for the best user experience. Use --non-interactive for scripted or automated setup with pre-provided credentials.

remotes list - List connected storage

Display all connected cloud storage accounts.

filefortress remotes list

Shows name, type, creation date, and last update time for each remote.

remotes show - Show remote details

Display detailed information about a specific remote (by name or id).

filefortress remotes show <remote_name_or_id>
remotes info - Comprehensive remote information

Display comprehensive storage information including usage statistics.

filefortress remotes info <remote_name_or_id> [--refresh]

Shows account details, storage statistics, scan status, and cached vs live data. Supports Google Drive, OneDrive, Amazon S3, and Backblaze B2. Runs in interactive mode by default for better data exploration.

remotes remove - Remove cloud storage

Remove a connected cloud storage account.

filefortress remotes remove <remote_name_or_id>

Requires confirmation unless cancelled.

remotes scan - Scan for files

Scan connected storage for files and update the index.

filefortress remotes scan <remote_name_or_id>

Fetches file information from the specified remote storage.

remotes enrich - Enrich file metadata

Enhance file metadata with additional information like file hashes.

filefortress remotes enrich [--query-name "query_name"]

Can be limited to files matching a specific stored query.

Common Usage Examples

Add Google Drive:
filefortress remotes add gdrive
Follow the interactive prompts to connect Google Drive.
Add Google Drive (with password):
filefortress --password mySecret remotes add gdrive
Connect Google Drive when using custom password mode.
Add Amazon S3 (scripted setup):
filefortress --key-file ~/filefortress.key remotes add s3 --non-interactive --access-key AKIA... --secret-key secret... --bucket my-bucket
Connects to a specific S3 bucket in non-interactive mode using a private key file for authentication.
Add Backblaze B2:
filefortress remotes add backblaze
Follow the interactive prompts to connect Backblaze B2.
Add Backblaze B2 (scripted setup):
filefortress --password mySecret remotes add backblaze --non-interactive --key-id 0057d6e... --application-key K007...
Connects to Backblaze B2 in non-interactive mode using Application Key ID and Application Key.
List all connected storage:
filefortress remotes list
Shows all remotes with basic information.
Get comprehensive storage info:
filefortress --key-file ~/filefortress.key remotes info "My Google Drive" --refresh
Shows detailed storage usage and statistics with fresh data using key file authentication.
Scan specific remote:
filefortress --password mySecret remotes scan "My Google Drive"
Scans the specified Google Drive account for files using password authentication.
Get Backblaze B2 storage info:
filefortress remotes info "My B2 Storage" --refresh
Shows detailed Backblaze B2 storage information including account ID, bucket count, and total file size.

Related Commands

setup
Complete onboarding including remote setup
View Command
search
Search files across all remotes
View Command
ls
Browse files in your remotes
View Command