Apache web server support special syntax checking. You can run syntax tests for configuration files only. Following two are important syntax checker option you can pass to apache binary program httpd (Red Hat/ Fedora Linux) or apache-perl (Debian Linux apache binary):


Executing the following command, that will detect syntax errors:

If you are using Debian Linux:

# /usr/sbin/apache-perl -t

Syntax OK

If you are using Red Hat Linux:

# /usr/sbin/httpd -t

Syntax OK


  • -t : The program immediately exits after these syntax parsing with either a return code of 0 (i.e. Syntax OK message) or return code not equal to 0 (i.e. Syntax Error message).

Consider following example:

# /usr/sbin/apache-perl -t

Warning: DocumentRoot [/data/network/www/blogs] does not exist
Syntax OK

Replace it with -T option:

/usr/sbin/apache-perl -T

Syntax OK

The option -T is same as option -t but does not check the configured document roots (warning message disappeared).

Another example:

# /usr/sbin/apache-perl -t -S

Syntax error on line 1059 of /etc/apache-perl/httpd.conf:
Invalid command ‘CustomLogl’, perhaps mis-spelled or defined by a module not included in the server configuration

As you see error on line number 1059 need to be fixed. Use vi text editor:

# vi +1059 /etc/apache-perl/httpd.conf

After correction again retype command:

# /usr/sbin/apache-perl -t รขโ‚ฌโ€œS


VirtualHost configuration:         is a NameVirtualHost
                      default server cyberciti.biz (/etc/apache-perl/httpd.conf:1053)
                      port 80 namevhost cyberciti.biz (/etc/apache-perl/httpd.conf:1053)
                      port 80 namevhost apps.cyberciti.biz (/etc/apache-perl/httpd.conf:1062)
                      port 80 namevhost dl.cyberciti.biz (/etc/apache-perl/httpd.conf:1069)
                      port 80 namevhost blogs.cyberciti.biz (/etc/apache-perl/httpd.conf:1076)

๐Ÿฅบ Was this helpful? Please add a comment to show your appreciation or feedback.

nixCrat Tux Pixel Penguin
Hi! ๐Ÿค 
I'm Vivek Gite, and I write about Linux, macOS, Unix, IT, programming, infosec, and open source. Subscribe to my RSS feed or email newsletter for updates.

0 comments… add one

Leave a Reply

Your email address will not be published. Required fields are marked *

Use HTML <pre>...</pre> for code samples. Your comment will appear only after approval by the site admin.