Skip to content
Clairos Learn

Server operations · Lesson 3 of 36 · 9 minutes

Nginx validation

Read training nginx config and validate it without making real server changes.

Mastery 0/3Run itExplain itApply it
learner@clairosSimulated Linux lab
learner@clairos:~ $
↑ history · Tab complete · Ctrl+C cancel · Esc, Tab to leaveExit 0

Understand the pattern

Validation catches broken config before it takes a service down.

cat
Read one or more files to standard output without editing their contents.

Reading a source file should precede changing it; avoid printing real secrets.

grep
Select input lines that match a pattern; -i ignores case, -n adds line numbers, and -v inverts selection.

No matches is exit status 1, which is different from a malformed invocation.

nginx
Check the simulated configuration using nginx -t before changing service state.

This lab checks a limited configuration subset, not the complete Nginx parser.

Worked example and expected result
$ cat /etc/nginx/sites-available/learn.conf
server {
  listen 443 ssl;
  server_name learn.clairos.ai;
  root /srv/www;
  location ^~ /api/learn/ { proxy_pass http://127.0.0.1:8010; }
  location ^~ /api/ { return 404; }
  add_header Content-Security-Policy "default-src 'self'; connect-src 'self'" always;
  # training config only
}

Exit status: 0. The command completed successfully in the training fixture.

$ grep /api/ /etc/nginx/sites-available/learn.conf
  location ^~ /api/learn/ { proxy_pass http://127.0.0.1:8010; }
  location ^~ /api/ { return 404; }

Exit status: 0. The command completed successfully in the training fixture.

$ nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Exit status: 0. The command completed successfully in the training fixture.

Try a variation

Repeat this workflow in the sandbox with a different scratch filename. Keep the system fixtures unchanged and compare the observed output with your expectation before moving on.

Explain it

In “Nginx validation”, which interpretation is safe?

Apply it elsewhere

Before adapting the grep workflow from “Nginx validation” to another server, what should you do?

Keep the momentum.

Complete the lab, then explain and apply the pattern.

Next: Resource inspectionTry an incident drill

Anonymous lesson and mastery progress lasts for this session. Sign in to keep synced lesson XP between sessions; mastery stays device-local. No speed bonus, lost lives, or hint penalties.

Keep learning

  1. 01Service inspectionCompare simulated service status and journal output before taking action.Practice
  2. 02Resource inspectionRead simulated disk, memory, uptime, and directory usage signals.Practice
  3. 03Host network viewInspect simulated hostname, addresses, and listening sockets.Practice