Using Multiple Accounts (Profiles)

The Command Line Interface (CLI) App allows you to access multiple Files.com accounts by specifying a different profile for each account.

This is useful when you need to access multiple accounts within a single Files.com site or when you have accounts across multiple Files.com sites, such as a Production site, Test site, and Child site.

To set up profiles for your Files.com accounts, use the following commands:

files-cli config set --subdomain="MYFIRSTCOMPANY" --username="FIRSTUSERNAME" --profile="firstaccount"
files-cli config set --subdomain="MYSECONDCOMPANY" --username="SECONDUSERNAME" --profile="secondaccount"
files-cli config set --endpoint="https://files.mythirdcompany.com" --username="THIRDUSERNAME" --profile="thirdaccount"

To execute commands for a specific account, use the --profile option in your command. For example:

files-cli folders list-for /path/to/folder/in/account1/ --profile="firstaccount"
files-cli folders list-for /path/to/folder/in/account2/ --profile="secondaccount"
files-cli folders list-for /path/to/folder/in/account3/ --profile="thirdaccount"

You can also configure API Keys for profiles:

files-cli config set --api-key="API_KEY_ONE" --profile="firstaccount"
files-cli config set --api-key="API_KEY_TWO" --profile="secondaccount"
files-cli config set --api-key="API_KEY_THREE" --profile="thirdaccount"

If the --profile option is not specified then all configuration and operations will use your default profile setting.

You can view the account profiles that have been configured by using this command:

files-cli config show

Profiles can be updated by using the config reset command.

For example, you can update the settings of a named profile using the following command:

files-cli config reset --subdomain="UPDATED_SITE_NAME" --username="UPDATED_USERNAME" --api-key="UPDATED_API_KEY" --profile="firstaccount"

The CLI App stores its configuration within a hidden file on your local system.

The file is located at %HOME%\.config\files-cli on Windows based systems and at $HOME/.config/files-cli on Linux and Mac based systems.

Do not edit this file directly unless directed to by our Support team.

You can factory-reset the CLI App to a blank starting state by deleting, renaming, or moving this configuration file.