proxy.flexfs

Note

Proxy groups are an Enterprise-only feature.

proxy.flexfs is a CDN-like block caching server that sits between mount clients and object storage. Multiple proxy servers form a proxy group. Mount clients distribute blocks across group members using rendezvous hashing and select groups based on RTT-based latency measurements.

Subcommands

Subcommand	Description
start	Start the proxy 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

proxy.flexfs start [flags]

Persistent Flags

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

Start Flags

Flag	Type	Default	Description	Visibility
--bindAddr	string	0.0.0.0:443	Address and port to bind	Public
--diskFolder	string	/cache	On-disk block cache folder path	Public
--diskQuota	string	95%	On-disk block cache capacity (e.g. 5%, 64M)	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
--sync	bool	false	Fsync dirty block writes for full crash durability	Public
--dbFolder	string	~/.flexfs/proxy/data	Database folder path	Public
--verbose, -v	bool	false	Enable verbose logging	Public
--blockPass	string		Block storage password (overrides creds file)	Internal
--blockUser	string		Block storage username (overrides creds file)	Internal
--bufferSize	uint32	1048576	I/O buffer size	Internal
--dbMemCapacity	string	10%	Database memory cache capacity (e.g. 5%, 64M)	Internal
--maxBops	uint32	0 (auto)	Maximum number of active parallel block operations	Internal
--noWriteback	bool	false	Disable writeback to persistent storage	Internal
--pprof	bool	false	Enable pprof profiler	Internal
--sse	bool	false	Enable S3 server-side encryption (AES256)	Internal
--writebackActive	uint32	0 (auto)	Maximum number of active parallel writeback operations	Internal
--writebackDelay	uint32	0	Milliseconds each writeback should sleep	Internal

Auto-computed Defaults

When --maxBops is left at 0, the proxy computes a default based on the host’s CPU count. --writebackActive defaults to the computed --maxBops value.