admin.flexfs

admin.flexfs is the central management server for flexFS Enterprise. It stores accounts, volumes, block stores, metadata stores, proxy groups, and volume tokens. Mount clients connect to it for volume settings and binary updates, and configure.flexfs uses its REST API to manage resources.

Subcommands

Subcommand	Description
`start`	Start the admin server
`init creds`	Initialize the credentials file
`init systemd`	Create and enable a systemd service unit
`deinit creds`	Remove the credentials file
`deinit systemd`	Remove the systemd service unit
`version`	Print the build version
`license`	Print license information

Usage

admin.flexfs start [flags]

Persistent Flags

Flag	Type	Default	Description
`--credsFile`	string	`~/.flexfs/admin/creds`	Credentials file path

Start Flags

Flag	Type	Default	Description	Visibility
`--bindAddr`	string	`0.0.0.0:443`	Address and port to bind	Public
`--dbFolder`	string	`~/.flexfs/admin`	Database folder path	Public
`--deployFolder`	string	`~/.flexfs/admin/deploy`	Folder for mount client deploy binaries	Public
`--noSSL`	bool	`false`	Disable SSL for the REST API	Public
`--sslCert`	string	`~/.flexfs/ssl/cert`	SSL certificate file path	Public
`--sslKey`	string	`~/.flexfs/ssl/key`	SSL private key file path	Public
`--verbose`, `-v`	bool	`false`	Enable verbose logging	Public
`--noStatSSL`	bool	`false`	Disable SSL for stat server connections	Internal
`--pprof`	bool	`false`	Enable pprof profiler	Internal
`--sqliteOpts`	string	(default tuning)	Database connection tuning options	Internal
`--statAddr`	string		Stat server address (overrides creds file)	Internal
`--token`	string		Admin server auth token (overrides creds file)	Internal

Init Creds

admin.flexfs init creds [flags]

Initializes a credentials file for the admin server. If --token is omitted, the command prompts for an admin server token interactively.

Flag	Type	Default	Description
`--statAddr`	string	`stat.flexfs.io`	Stat server address
`--token`	string	`""`	Admin server auth token (will prompt if omitted)
`--force`	bool	`false`	Overwrite existing creds file

Init Systemd

sudo admin.flexfs init systemd [flags]

Creates and enables a systemd service unit (flexfs-admin.service) for the admin server. Requires root.

Flag	Type	Default	Description
`--now`	bool	`false`	Start the service immediately after enabling
`--startFlags`	string	`""`	Additional flags to pass to the start command
`--force`	bool	`false`	Overwrite existing systemd unit file

Deinit Creds

admin.flexfs deinit creds [flags]

Removes the credentials file for the admin server. If the credentials file is referenced by a systemd unit, the command refuses unless --force is passed, in which case it removes the references too.

Flag	Type	Default	Description
`--force`	bool	`false`	Remove creds even if referenced by systemd (removes references too)

Deinit Systemd

sudo admin.flexfs deinit systemd

Removes the systemd service unit (flexfs-admin.service) for the admin server. Requires root.

Deploy Endpoints

The admin server serves mount client binaries and an installer script for auto-update and client deployment:

Endpoint	Description
`/deploy/install-mount.sh`	Shell script that downloads and configures the mount client
`/deploy/production/`	Production channel mount client binaries
`/deploy/staging/`	Staging channel mount client binaries