| name | systemd-services |
| description | Manage systemd services on Linux servers - start, stop, restart, enable, check logs |
| user-invocable | true |
| os | ["linux"] |
| navig-commands | ["navig run \"systemctl status {service}\"","navig run \"systemctl start {service}\"","navig run \"systemctl stop {service}\"","navig run \"systemctl restart {service}\"","navig run \"systemctl enable {service}\"","navig run \"journalctl -u {service} --no-pager -n 50\""] |
| examples | ["Is nginx running?","Restart the MySQL service","Show me service logs","What services are failed?","Enable the service to start on boot"] |
Systemd Service Management
Manage services on Linux servers using systemd — start, stop, restart, check status, view logs.
Common Tasks
Check Service Status
User says: "Is nginx running?" / "Check MySQL status"
navig run "systemctl status {service} --no-pager"
Response format:
🔧 Service: nginx
Status: ✅ Active (running)
PID: 1234
Uptime: 15 days
Memory: 32MB
Last log entries:
[OK] Started Nginx web server
Start a Service
navig run "systemctl start {service}"
Stop a Service
⚠️ Confirm first: "This will stop {service}. Continue?"
navig run "systemctl stop {service}"
Restart a Service
navig run "systemctl restart {service}"
Response:
🔄 Restarting {service}...
✅ Service restarted successfully!
Reload Configuration (no downtime)
navig run "systemctl reload {service}"
Enable on Boot
navig run "systemctl enable {service}"
Disable on Boot
navig run "systemctl disable {service}"
Diagnostics
View Service Logs
navig run "journalctl -u {service} --no-pager -n 50"
View Logs Since Last Boot
navig run "journalctl -u {service} --no-pager -b"
View Logs from Time Range
navig run "journalctl -u {service} --since '1 hour ago' --no-pager"
List All Failed Services
User says: "Are any services failing?"
navig run "systemctl --failed --no-pager"
Response format:
🔧 Service Health on {host}:
❌ Failed services:
• php8.2-fpm.service - PHP FastCGI Process Manager
• certbot.timer - Certificate renewal timer
✅ All other services running normally
💡 Fix php-fpm: check `journalctl -u php8.2-fpm -n 30`
List Running Services
navig run "systemctl list-units --type=service --state=running --no-pager"
Check If Service Exists
navig run "systemctl list-unit-files | grep {service}"
Common Services
| Service | Package | Default Port |
|---|
nginx | nginx | 80, 443 |
apache2 | apache2 | 80, 443 |
mysql | mysql-server | 3306 |
postgresql | postgresql | 5432 |
redis-server | redis | 6379 |
docker | docker-ce | - |
ssh / sshd | openssh-server | 22 |
ufw | ufw | - |
fail2ban | fail2ban | - |
cron | cron | - |
Safety Rules
- Safe:
status, list-units, journalctl (read-only)
- Confirm:
start, restart, reload (service disruption)
- Double confirm:
stop, disable (takes service offline)
Proactive Suggestions
- Service crashed: "💡 {service} has crashed {n} times today. Check logs with
journalctl -u {service}"
- Not enabled: "⚠️ {service} is running but not enabled on boot. Enable it?"
- High restart count: "⚠️ {service} has restarted 5 times. Something might be wrong."
Error Handling
- Service not found: "Service '{service}' not found. Did you mean '{suggestion}'?"
- Permission denied: "Need sudo. Try:
navig run --sudo 'systemctl restart {service}'"
- Already running: "{service} is already running. Nothing to do."
