Config errors
Programs on your server read their settings from config files. A small typo — a missing semicolon or a wrong path — can stop the web server or database from starting, often right when it’s restarted after an update.
- At a glance
- Group
- Maintenance
- Mellonbot
- Can fix it
- What it does
- Pinpoints the line and fixes it, with a backup first.
- Approval
- Always with your OK, or your access mode
What you’ll notice
- A service won’t start after a change or an update
- The site went down right after someone edited a setting
- Errors like “syntax error” or “unknown directive” in the logs
- Reloading the web server fails
Why it usually happens
- A typo when editing a settings file
- A setting that a newer version no longer supports
- A file path that doesn’t exist any more
- Two settings files that conflict with each other
Fix it yourself
How to fix it by hand
Comfortable with a terminal? Here’s what an experienced admin would do. Start with the read-only commands.
- 01
Test the nginx settings
Prints the exact file and line of any mistake.
sudo nginx -t - 02
Test Apache instead, if you use it
Same idea for Apache.
sudo apachectl configtest - 03
Read the service’s error
The log shows why the service refused to start.
sudo journalctl -u nginx -n 30 --no-pager - 04
Fix the line and reload
After correcting the file, test again and only reload if the test passes.
sudo nginx -t && sudo systemctl reload nginx
With Mellonbot
How Mellonbot fixes it
- Tests your service settings and finds the exact file and line that’s wrong.
- Explains the mistake in plain English.
- Offers to fix the line — backing up the file first and testing before anything is reloaded.
- Undo is one click for 14 days if you’d rather go back.
FAQ
Config errors: common questions
How do I check my nginx config for errors?
Run sudo nginx -t. It checks every settings file and tells you the file and line of any problem, without restarting anything.
Why did my site break after an update?
Updates sometimes restart services, and a settings mistake that went unnoticed before stops them from starting again.
Private alpha · invites in small waves
Let Mellonbot look after your server
Join the alpha with one email address. Early testers help shape Mellonbot and keep the founding-member perks after launch.
- No card needed
- Leave any time