Manage Cloud Storage
Manage connections to cloud storage providers like Google Drive, OneDrive, Amazon S3, Backblaze B2, and Local storage.
Recommended: Use Your Own OAuth Credentials
For Google Drive and OneDrive, we recommend using remotes add oauth with your own Client ID and Secret. This way FileFortress never handles your tokens, and you control exactly which permissions to grant.
Connect Google Drive, OneDrive, or any OAuth-based provider using your own Client ID and Client Secret. This is the recommended approach for all OAuth providers.
Why use your own credentials?
filefortress remotes add oauthfilefortress remotes add oauth --name "My Drive" --provider gdrive --client-id YOUR_ID --client-secret YOUR_SECRET--name
Friendly name for this remote
--provider
e.g. gdrive, onedrive
--client-id
Your OAuth Client ID
--client-secret
Your OAuth Client Secret
--encryption-type - RCloneStandard, RCloneObfuscate, Aes256Cbc, None--encryption-password - Password for encryption--encryption-salt - Optional salt for key derivationDeprecation Notice: gdrive and onedrive
The remotes add gdrive and remotes add onedrive commands will be retired in a future release. Please use remotes add oauth instead — it gives you full control over your credentials and permissions, and FileFortress never touches your tokens.
Add a new cloud storage provider with provider-specific subcommands.
filefortress remotes add gdrive [--name "name"]filefortress remotes add onedrive [--name "name"]filefortress remotes add s3 --access-key KEY --secret-key SECRETfilefortress remotes add backblaze --key-id ID --application-key KEYfilefortress remotes add local --path PATH--encryption-type - RCloneStandard, RCloneObfuscate, Aes256Cbc, None--encryption-password - Password for encryption--encryption-salt - Optional salt for key derivationDisplay all connected cloud storage accounts.
filefortress remotes list
Shows name, type, creation date, and last update time for each remote.
Display detailed information about a specific remote.
filefortress remotes show <remote_name_or_id>
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.
Remove a connected cloud storage account.
filefortress remotes remove <remote_name_or_id>
Requires confirmation unless cancelled.
Scan connected storage for files and update the index.
filefortress remotes scan <remote_name_or_id>
Fetches file information from the specified remote storage.
filefortress remotes scan --all
Scans all connected remotes sequentially and displays aggregate statistics.
Enhance file metadata with additional information from cloud providers.
filefortress remotes enrich [options]
--from-query, -q
Use a saved query
--remote, -r
Specific remote
--media-type
Filter by media type
--migrate-metadata
NEW
Migrate to structured format
filefortress remotes add oauth
Follow the interactive prompts. You'll provide your own Client ID and Secret — FileFortress never sees your tokens.
filefortress remotes add oauth --provider onedrive --name "My OneDrive"
Connects OneDrive using your own Azure app credentials. You choose the permission scopes.
filefortress remotes add s3 --non-interactive --access-key AKIA... --secret-key secret... --bucket my-bucket
filefortress remotes add oauth --provider gdrive --name "Encrypted Drive" --encryption-type RCloneStandard --encryption-password "mypassword"
Uses your own OAuth credentials plus rclone-compatible encryption on top.
filefortress remotes list
filefortress remotes enrich --media-type Image --extension .jpg --extension .png
Enriches only image files with EXIF data and dimensions.
filefortress remotes enrich --migrate-metadata
Converts existing metadata to structured format without re-fetching.