Use SBFS, a command line tool, to interact with project files mounted as a local file system. The general syntax for the SBFS commands is:

sbfs [global-parameters] command [command-parameters]

Global parameters

Global parameters can be used anywhere within the command line. On the other hand, command-specific parameters can only be used after specifying the command.

If a global parameter is not applicable for a given command, it will be ignored. For an example, if you use an --api-endpoint parameter with the version command or --profile parameter with the unmount command the specified global parameter will be ignored.

The following global parameters are available:

ParameterDescription
--profile <profile-name>The configuration profile from the unified configuration file. If omitted, the default profile ("default") is used.
--api-endpoint <url>Use this parameter to explicitly provide the API endpoint for BioData Catalyst powered by Seven Bridges: https://api.sb.biodatacatalyst.nhlbi.nih.gov/v2.

This parameter must be used in combination with explicitly passing your authentication token as mentioned below.

If this parameter is provided explicitly through the command line, it overrides stored parameters within the unified configuration file or environment variables.
--auth-token <token>Use this parameter to pass your authentication token explicitly. This parameter must be used in combination with explicitly passing the API endpoint, as mentioned above.
If these parameters are provided through the command line, they will override the parameters specified in the credentials file or as environment variables.
debugThis parameter Includes debug information in the output (verbose output).
--helpUse this parameter to display help for a specific command.

Commands

The following commands are available. Learn more about each command from the resources below the table.

CommandDescription
configureConfigure credentials for accessing a project on the Platform.
listList projects which are available for mounting.
mountMount files from the specified Seven Bridges project as a local file system.
unmountUnmount a file system previously mounted via SBFS.
versionDisplay the currently used version of the application.
`helpDisplay help on a specific command or display general help if the command is omitted.

Resources