Documentation
/
Commands
/
device

device - Device Management
Manage your FileFortress device

The device command provides comprehensive management of your FileFortress device registration, including viewing device information, enabling/disabling the device, refreshing profile data, changing passwords, and removing device registration.

Device Registration

Every machine using FileFortress must be registered as a device. Use these commands to manage your device's lifecycle and configuration.

Subcommands

device info - Display device information

Display essential information about this device and your account, including device name, status, registration date, last active time, subscription tier, remote account usage, and authentication status.

Syntax:

filefortress device info

Information Displayed:

Account: Your account email
Device Name: The name of this device
Device Type: The type of device (Desktop, Laptop, Server, etc.)
Status: Device status (Enabled, Disabled, or Deleted)
Subscription Tier: Your current plan (Free, Pro, Enterprise)
Remote Accounts: Number of remote storage accounts used vs limit
Authentication: Token validity and expiration status
device enable - Enable this device

Enable this device for FileFortress operations. Useful if you previously disabled the device and want to re-enable it.

Syntax:

filefortress device enable

Note: Devices are enabled by default during initialization. You only need this command if you previously disabled your device.

device disable - Disable this device

Disable this device, blocking most FileFortress operations until you re-enable it. This is useful if you want to temporarily stop using FileFortress on this machine without removing it completely.

Syntax:

filefortress device disable [options]

Options:

Option Description
--confirm Confirm device disable (required in non-interactive mode)

Warning: Disabling your device will block most FileFortress operations. You can re-enable it at any time using device enable.

Interactive Mode:

You will be prompted to confirm the action.

filefortress device disable

Non-Interactive Mode:

You must use the --confirm flag.

filefortress --non-interactive device disable --confirm
device refresh - Refresh device profile

Refresh device profile and account information from the server. This synchronizes your local device data with the latest information from your FileFortress account, including subscription changes, device limits, and account status.

Syntax:

filefortress device refresh

When to Use:

After upgrading or downgrading your subscription
If you've made changes in the web portal
To ensure your access token is up to date
If you're experiencing authentication issues

Note: FileFortress automatically checks for profile updates every 30 minutes. Use this command to force an immediate refresh.

device change-password - Change device password

Change your device's custom password. This command only works if you initialized your device with a custom password (not using automatic encryption).

Syntax:

filefortress --password [current] device change-password [options]

Options:

Option Description
--new-password New password (required for script mode, optional for interactive mode)

Important: This command only works if you're using a custom password. Devices using automatic encryption (default) cannot use this command.

Interactive Mode:

You will be prompted to enter and confirm your new password.

filefortress --password myCurrentPassword device change-password

Non-Interactive Mode:

filefortress --password myCurrentPassword --non-interactive device change-password --new-password myNewPassword
device remove - Remove device registration

Remove this device and deregister all remote storage accounts created on it from your FileFortress account. This is a destructive operation that cannot be undone.

Syntax:

filefortress device remove [options]

Options:

Option Description
--confirm Confirm device removal (required in non-interactive mode)
⚠️ Destructive Operation

This action will:

  • Remove the device registration from the server
  • Deregister all remote accounts created on this device
  • This cannot be undone

To use FileFortress again on this machine, you'll need to run filefortress reinit.

Interactive Mode:

You will be prompted to confirm the action.

filefortress device remove

Non-Interactive Mode:

filefortress --non-interactive device remove --confirm

Common Use Cases

Check device status and account limits
Use device info to see your current subscription tier, remote account usage, and device status.
Sync account changes
After upgrading your subscription or making changes in the web portal, use device refresh to sync the latest information.
Temporarily disable device
If you want to stop using FileFortress temporarily without removing it completely, use device disable.
Update password
If you're using a custom password and want to change it, use device change-password.

Examples

View device information:
filefortress device info
Displays comprehensive information about your device and account.
Refresh device profile:
filefortress device refresh
Syncs your device with the latest account information from the server.
Disable device (interactive):
filefortress device disable
Disables your device after confirmation prompt.
Disable device (non-interactive):
filefortress --non-interactive device disable --confirm
Disables your device in script mode with explicit confirmation.
Re-enable device:
filefortress device enable
Re-enables a previously disabled device.
Change password (interactive):
filefortress --password myCurrentPassword device change-password
Changes your device password with interactive prompts.
Remove device (interactive):
filefortress device remove
Removes device registration after confirmation.

Best Practices

Run device info regularly to monitor your account status and remote account usage
Use device refresh after making subscription or account changes in the web portal
Prefer device disable over device remove if you plan to use the device again
Always use confirmation flags in non-interactive mode for destructive operations
If you remove a device, use reinit (not init) to re-register it

Related Commands

init
Initialize your device for first-time use
View Command
reinit
Re-register a removed device
View Command
remotes
Manage cloud storage connections
View Command