Skip to Content
ReferenceCLI Reference

CLI Reference

Commands

qaws [options] qaws check --config <file> qaws status [options] qaws stop [options] qaws restart [options] qaws help qaws version

Server options

OptionValueDefault
--hostaddress0.0.0.0
--portport80
--servedirectory./public
--configfilenone

Logging options

OptionValueDefault
--log-formatplain or jsonlplain
--log-filepathstderr or derived daemon path
--access-lognoneenabled
--no-access-lognoneenabled

HTTP and performance options

OptionValueDefault
--keep-alivenoneenabled
--no-keep-alivenoneenabled
--sendfilenoneenabled
--no-sendfilenoneenabled
--keep-alive-timeout-mspositive integer5000
--max-requests-per-connectionpositive integer1000
--max-connectionspositive integer1024
--workerspositive integertopology-selected automatic count

Daemon options

OptionValueDefault
-dnoneforeground
--pid-filepathderived
--log-filepathderived in daemon mode
--forcenoneonly for stop and restart

Examples

Foreground local:

qaws --host 127.0.0.1 --port 8080 --serve ./public

Foreground LAN:

qaws --host 0.0.0.0 --port 8080 --serve ./public

Config with CLI override:

qaws --config qaws.json --port 18086 --no-access-log

Daemon:

qaws -d --pid-file /tmp/qaws.pid --log-file /tmp/qaws.log --port 18086

Daemon stop:

qaws stop --pid-file /tmp/qaws.pid --force

Version:

qaws version

Expected output:

qaws 0.2.7

ETags, ranges, and precompressed sidecars are configured only through strict JSON in 0.2.7; they intentionally do not add CLI flags.

qaws docs. Built for static hosting.