Prerequisites
What you need before getting started

FileFortress Account
Create a free account on this website to get your unique registration code.
CLI Application
Download and install the FileFortress CLI for your operating system.
Registration Code
Get your unique registration code from the dashboard after logging in.

Step-by-Step Setup
Follow these steps to get FileFortress CLI up and running

Install CLI
Download and install the application
Get Registration Code
Copy code from dashboard
Run Setup Command
One command does it all!

Step 1: Install FileFortress CLI

Installation Instructions

Download the appropriate installer for your operating system and follow the installation wizard.

Download FileFortress CLI v0.16.0

Released on September 30, 2025

Windows
Download the .msi installer and run it with administrator privileges.
macOS
Download the .pkg installer or use Homebrew for installation.
Linux
Download the .deb/.rpm package or use the universal binary.
Verify Installation

After installation, open a terminal/command prompt and run:

filefortress --version

This should display the version number if installation was successful.

Step 2: Get Your Registration Code

Login Required

You need to log in to your FileFortress account to get your registration code.

Login to Account
Login
Sign in to your account
Dashboard
Navigate to dashboard
Copy Code
Copy registration code

Step 3: Run the Setup Command

Once you have your registration code, run our new one-step setup command:

🚀 New Users: Use This Command!

This is the easiest way to get started. The setup command will do everything for you in one interactive session.

filefortress setup
What this command does:
  • Device Initialization: Prompts for your registration code and sets up your device
  • Security Setup: Asks if you want to set up a custom password (recommended) and optionally creates a key file
  • Cloud Storage Connection: Guides you through connecting Amazon S3, Google Drive, or OneDrive
  • Initial File Scan: Automatically scans your connected storage to build the search index
  • Verification: Ensures everything is working correctly
Amazon S3
Connect your S3 buckets for enterprise file storage.
Google Drive
Connect your Google Drive account for file access and search.
OneDrive
Connect Microsoft OneDrive for business or personal use.
Backblaze B2
Connect your Backblaze B2 buckets for cost-effective cloud storage.
Advanced Users: Individual Commands

If you prefer more control, you can still use the individual commands:

Initialize device only:
filefortress init (runs interactive by default) or filefortress init --code YOUR_CODE --name "Device Name" (non-interactive)
Add storage accounts:
filefortress remotes add
Scan files:
filefortress remotes scan "Remote Name"
Password Setup Note

Both setup and init handle password configuration the same way - during the interactive session, you'll be asked if you want to set up a custom password and key file.

🎉 Setup Complete!

After the setup command finishes, you'll have a fully configured FileFortress installation ready to search your cloud files!

Verify Your Setup

Run these commands to verify everything is working correctly:

Check device registration:
filefortress device info
Should display your device information and registration status.
List connected remotes:
filefortress remotes list
Should show all your connected cloud storage accounts.
Test search functionality:
filefortress search "test"
Should return search results from your connected storage.

Next Steps

Explore Search
Learn how to use the powerful search capabilities to find files across all your storage.
Command Reference
Browse the complete reference of all available CLI commands and their options.
Usage Examples
See real-world examples and common workflows to get the most out of FileFortress.