frogdb-server

The main FrogDB server process.

frogdb-server [OPTIONS]

Options

Option	Short	Type	Default	Description
--config <FILE>	-c	path		Path to TOML configuration file
--bind <ADDR>	-b	string	127.0.0.1	Bind address
--port <PORT>	-p	integer	6379	Listen port
--shards <N>	-s	string	1	Number of shards. auto = number of CPU cores
--log-level <LEVEL>	-l	enum	info	Log level: trace, debug, info, warn, error
--log-format <FORMAT>		enum	pretty	Log format: pretty, json
--admin-bind <ADDR>		string		Admin bind address (overrides config)
--admin-port <PORT>		integer		Admin port (implies admin.enabled = true)
--http-bind <ADDR>		string		HTTP server bind address (overrides config)
--http-port <PORT>		integer		HTTP server port (overrides config)
--http-token <TOKEN>		string		Bearer token for protected HTTP endpoints (/admin/*, /debug/*)
--tls-enabled		flag	false	Enable TLS
--tls-cert-file <FILE>		path		TLS certificate file (PEM)
--tls-key-file <FILE>		path		TLS private key file (PEM)
--tls-ca-file <FILE>		path		TLS CA certificate file (PEM) for client verification
--tls-port <PORT>		integer		TLS listen port
--tls-require-client-cert <MODE>		enum		Client certificate mode: none, optional, required
--tls-replication		flag	false	Encrypt replication connections with TLS
--tls-cluster		flag	false	Encrypt cluster bus connections with TLS
--generate-config		flag		Print default configuration to stdout and exit
--intrinsic-latency <SECS>		integer		Run latency test for N seconds and exit
--startup-latency-check		flag	false	Run latency check before accepting connections

Examples

# Start with defaults
frogdb-server

# Start with config file
frogdb-server --config /etc/frogdb/frogdb.toml

# Auto-detect shards, bind to all interfaces
frogdb-server -b 0.0.0.0 -s auto

# Generate default config
frogdb-server --generate-config > frogdb.toml

# Enable TLS
frogdb-server --tls-enabled --tls-cert-file server.crt --tls-key-file server.key

# Enable debug UI with auth token
frogdb-server --http-port 9090 --http-token my-secret-token

# Run intrinsic latency test
frogdb-server --intrinsic-latency 10

Environment Variables

All configuration fields can be overridden via environment variables with the FROGDB_ prefix. Use double underscores (__) to separate nested keys:

FROGDB_SERVER__BIND=0.0.0.0
FROGDB_SERVER__PORT=6380
FROGDB_PERSISTENCE__DURABILITY_MODE=sync
FROGDB_MEMORY__MAXMEMORY=4294967296

See Also

Configuration Reference All configuration options

Reference Config File Complete config with defaults

frogctl Operational CLI tool