FEVER-RUN(1)

πŸ’– FEVER-RUN β€” the run girlies' era πŸ’–

okay so this is fever-run from the FEVER manual (section 1, bestie, the classics ✨). it's the page that tells you how to start the FEVER service. strap in. πŸŽ€


🌸 NAME 🌸

fever-run β€” start FEVER service

like. that's the whole vibe. it starts the service. slay.


πŸ¦‹ SYNOPSIS πŸ¦‹

fever run [flags]

that's it. that's the incantation. fever run and then whatever flags your heart desires πŸ’…


✨ DESCRIPTION ✨

the run command starts the FEVER service. and when I say starts, I mean it's literally doing the most: it's consuming events from the input and executing all the processing components. every single one. no cap. it's giving main character energy, it's giving workhorse, it's giving "I don't take breaks." 🫢


πŸ‘‘ OPTIONS πŸ‘‘

okay this is the long one. hydration check, bestie, we're going through ALL of them, and yes I mean all 48. nobody gets left behind. πŸ’–

  • --active-rdns[=false] β€” turn on active rDNS enrichment for src/dst IPs πŸ¦‹
  • --active-rdns-cache-expiry=2m0s β€” how long rDNS lookups get to chill in the cache before expiry
  • --active-rdns-private-only[=false] β€” only do active rDNS enrichment for RFC1918 IPs (the private ones, iykyk)
  • --bloom-alert-prefix="BLF" β€” the string prefix used for Bloom filter alerts ✨
  • --bloom-blacklist-iocs=[/,/index.htm,/index.html] β€” blacklisted strings in the Bloom filter. ⚠️ heads up: these will cause the filter to be rejected, so don't just throw stuff in there
  • -b, --bloom-file="" β€” the Bloom filter for external indicator screening
  • -z, --bloom-zipped[=false] β€” use a gzipped Bloom filter file πŸŽ€
  • -c, --chunksize=50000 β€” chunk size for batched event handling (think inserts)
  • --context-cache-timeout=1h0m0s β€” how long flow metadata sticks around for uncompleted flows
  • --context-enable[=false] β€” collect and forward flow context for alerted flows
  • --context-submission-exchange="context" β€” the exchange that flow context events get submitted to
  • --context-submission-url="amqp://guest:guest@localhost:5672/" β€” the URL flow context gets submitted to
  • -d, --db-database="events" β€” database DB πŸ—„οΈ
  • --db-enable[=false] β€” write events to the database
  • -s, --db-host="localhost:5432" β€” database host
  • --db-maxtablesize=500 β€” maximum allowed cumulative table size, in GB
  • -m, --db-mongo[=false] β€” use MongoDB πŸ’œ
  • -p, --db-password="sensor" β€” database password πŸ”
  • --db-rotate=1h0m0s β€” time interval for database table rotations
  • -u, --db-user="sensor" β€” database user
  • --dummy[=false] β€” log locally instead of sending home 🏠
  • --flowextract-bloom-selector="" β€” IP address Bloom filter used to select which flows to extract
  • --flowextract-enable[=false] β€” extract and forward flow metadata
  • --flowextract-submission-exchange="flows" β€” the exchange raw flow events get submitted to
  • --flowextract-submission-url="amqp://guest:guest@localhost:5672/" β€” the URL raw flow events get submitted to
  • -n, --flowreport-interval=0s β€” time interval for report submissions
  • --flowreport-nocompress[=false] β€” send uncompressed flow reports (default is gzip, fyi)
  • --flowreport-submission-exchange="aggregations" β€” the exchange flow reports get submitted to
  • --flowreport-submission-url="amqp://guest:guest@localhost:5672/" β€” the URL flow reports get submitted to
  • --flushcount=100000 β€” maximum number of events in one batch (for flow extraction, for example)
  • -f, --flushtime=1m0s β€” time interval for event aggregation ⏰
  • -T, --fwd-all-types[=false] β€” forward ALL event types, no filter, no discrimination πŸ”₯
  • -t, --fwd-event-types=[alert,stats] β€” which event types get forwarded to the socket
  • --heartbeat-enable[=false] β€” forward the HTTP heartbeat event πŸ’“
  • --heartbeat-times=[] β€” times of day to send the heartbeat (a list of 24h HH:MM strings)
  • -h, --help[=false] β€” help for run 🫢
  • --in-buffer-drop[=true] β€” drop incoming events on the FEVER side instead of blocking the input socket
  • --in-buffer-length=500000 β€” input buffer length, counted in EVE objects
  • -r, --in-redis="" β€” Redis input server (it assumes the "suricata" list key, no pwd)
  • --in-redis-nopipe[=false] β€” do not use Redis pipelining
  • -i, --in-socket="/tmp/suri.sock" β€” filename of the input socket (accepts EVE JSON) 🐍
  • --ip-alert-prefix="IP-BLACKLIST" β€” string prefix for IP blacklist alerts
  • --ip-blacklist="" β€” list of IP ranges to alert on
  • --logfile="" β€” path to the log file
  • --logjson[=false] β€” output logs in JSON format
  • --metrics-enable[=false] β€” submit performance metrics to the central sink πŸ“Š
  • --metrics-submission-exchange="metrics" β€” the exchange metrics get submitted to
  • --metrics-submission-url="amqp://guest:guest@localhost:5672/" β€” the URL metrics get submitted to
  • -o, --out-socket="/tmp/suri-forward.sock" β€” path to the output socket (to the forwarder). empty string disables forwarding entirely
  • --pdns-enable[=false] β€” collect and forward aggregated passive DNS data
  • --pdns-submission-exchange="pdns" β€” the exchange passive DNS events get submitted to
  • --pdns-submission-url="amqp://guest:guest@localhost:5672/" β€” the URL passive DNS events get submitted to
  • --profile="" β€” enable runtime profiling to the given file
  • --reconnect-retries=0 β€” number of retries when connecting to a socket or sink. 0 = no retry limit, go off king πŸ‘‘
  • --toolname="fever" β€” set the toolname
  • -v, --verbose[=false] β€” enable verbose logging (debug log level) πŸ”

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

the family heirlooms, bestie. these come from the parent πŸ’œ

  • --config="" β€” config file (default is $HOME/.fever.yaml)
  • --mgmt-host="" β€” hostname:port definition for the management server
  • --mgmt-network="tcp" β€” network (tcp/udp) definition for the management server
  • --mgmt-socket="/tmp/fever-mgmt.sock" β€” socket path for the management server

🌈 SEE ALSO 🌈

the origin story. go read it. πŸ’–


and that's the whole page, bestie!! ✨ this was FEVER, version vibes from Sep 2025, section 1 β€” FEVER-RUN(1). now go start that service, you absolute icon. periodt. πŸ’…πŸ¦‹

πŸ“¦ where this page comes from