Configuration testing (nginx -t) - Mini Project: Build & Apply

Configuration testing with nginx -t

📖 Scenario: You are setting up a web server using nginx. Before starting the server, you want to make sure your configuration file has no errors. This helps avoid downtime caused by bad settings.

🎯 Goal: Learn how to create a basic nginx configuration file and test it using the nginx -t command to check for syntax errors.

📋 What You'll Learn

Create a simple nginx configuration file with a server block

Add a listen directive for port 80

Add a server_name directive with the value localhost

Use nginx -t to test the configuration file syntax

💡 Why This Matters

🌍 Real World

Web servers like nginx must have correct configuration files to run smoothly. Testing the config before starting prevents downtime and errors.

💼 Career

DevOps engineers and system administrators regularly test nginx configurations to ensure reliable web service deployment.

1

Create a basic nginx configuration file

Create a file named nginx.conf with a http block containing a server block. Inside the server block, add a listen 80; directive.

Nginx

# Your nginx.conf file should start like this:
http {
    server {
        listen 80;
        # Your code here
    }
}

Need a hint?

Remember to open and close the http and server blocks with curly braces.

2

Add the server_name directive

Inside the existing server block in nginx.conf, add the line server_name localhost; below the listen 80; directive.

Nginx

http {
    server {
        listen 80;
        # Add server_name localhost; below
    }
}

Need a hint?

The server_name directive tells nginx which hostnames this server block should respond to.

3

Test the nginx configuration syntax

Run the command nginx -t -c ./nginx.conf to test the syntax of your nginx.conf file.

Nginx

# Run the command below in your terminal
# Your code here

Need a hint?

The -t option tells nginx to test the configuration file for syntax errors without starting the server.

4

Check the output of the configuration test

After running nginx -t -c ./nginx.conf, observe the output. It should say syntax is ok and test is successful. Write a print statement that outputs exactly Configuration test successful.

Nginx

# Write a print statement to show the success message
# Your code here

Need a hint?

This print statement simulates confirming the configuration test passed.