Validate an HAProxy configuration
Build a paste-ready command, then review its compatibility and effects before running it.
haproxy -c -f /etc/haproxy/haproxy.cfgread-onlyno known side effects Compatibility
LinuxVerified for Linux using posix, bash, zsh syntax.
Operational knowledgereview due 2027-01-20
Requirementshaproxyhaproxy must be installed and available on PATH.
Version supporthaproxy Current supported releasesVerified for linux using posix, bash, zsh syntax; consult compatibility notes for platform-specific differences.
Expected signalsConfiguration file is validRepresentative successful output; values vary with the selected target and system state.
Known errorshaproxy: command not foundhaproxy is missing or is not available on PATH.
Verifyhaproxy -c -f /etc/haproxy/haproxy.cfgThe output matches the expected target and exits without an error.Rollback noteNot required: this command is read-only and does not change system state.
Command breakdown
01haproxyCommandRuns the haproxy stage of this one-liner.
02-cOptionConfigures haproxy with the -c option.
03-fOptionKeeps following new output or selects the command-specific force/file mode.
04/etc/haproxy/haproxy.cfgArgumentPasses /etc/haproxy/haproxy.cfg to haproxy.
Example input
haproxy -c -f /etc/haproxy/haproxy.cfg
Example output
Configuration file is valid
Illustrative output — exact values vary by system and data.
Official sources