How do I test and reload Apache on Ubuntu or a RHEL-family server?
Apache’s configuration test reports syntax errors before you apply a change. The wrapper and service names depend on the distribution: apache2ctl and apache2 are common on Ubuntu/Debian; apachectl and httpd are common on RHEL-family systems. Use the branch that matches the running installation.
Before you start
- An approved configuration change and the actual Apache unit name.
Instructions
1. Choose the correct wrapper
Check the installed command and running service first. Control-panel or source-built installations may use a separate configuration tree and must use their own supported control command.
command -v apache2ctl apachectl
systemctl status apache2 httpd --no-pagerIdentifies available wrappers and units; a missing alternative unit is not a failure of the active installation.
2. Test and reload the selected installation
Use one of the following alternatives, not both. The test must succeed before the corresponding reload command runs.
sudo apache2ctl configtest && sudo systemctl reload apache2Ubuntu/Debian example for the standard apache2 unit.
sudo apachectl configtest && sudo systemctl reload httpdRHEL-family example for the standard httpd unit.
3. Verify the affected hostname
Check the service journal using the chosen unit name, then request the site through its normal hostname so virtual-host routing is exercised.
curl --head --connect-timeout 5 --max-time 15 https://app.example.com/Tests the intended public site while retaining normal TLS verification.
Check the result
- The syntax test reports success, the correct unit remains active and affected sites serve their expected responses.
Troubleshooting
- The config test succeeds but the site fails
- Review the selected virtual host, application logs, certificate and upstream behaviour. Syntax validation does not test application dependencies.
Official references
Use the documentation for your installed version when a flag, service name or platform feature differs.