Account Management

Note

Account management is an Enterprise-only feature. Community edition uses a single auto-generated account.

An account represents an administrative user in flexFS Enterprise. Accounts are created automatically during the initial installation and are used to authenticate with the admin server via configure.flexfs and the REST API.

Account Fields

Field	Type	Description
id	integer	Unique account identifier (auto-assigned)
name	string	Account display name
email	string	Contact email address
token	string	Authentication token (UUID)
created_at	timestamp	Account creation time

Listing Accounts

configure.flexfs list accounts

The list view displays id, name, and email.

Viewing Account Details

configure.flexfs show account <id>

The full detail view includes all fields, including the authentication token.

Updating an Account

Accounts support updating name, email, and token:

configure.flexfs update account <id> --name "Admin User" --email admin@example.com

To rotate an account’s authentication token:

configure.flexfs update account <id> --token $TOKEN

Caution

After rotating a token, update the credentials file for every configure.flexfs installation that uses this account. Run configure.flexfs init creds --force with the new token.

Account Tokens

Each account has an authentication token (UUID) used to authenticate API requests. This token is stored in the configure.flexfs credentials file and passed in API request headers.

The account token is distinct from volume tokens, which grant mount access to specific volumes. Account tokens grant administrative access to the admin server API.

Multi-Tenancy

In multi-tenant deployments, each tenant can have a separate account. Volumes are associated with accounts, so each tenant’s volumes are isolated from other tenants. The account ID is recorded on each volume as account_id.