Installing and Starting Nginx on Fedora

What is Nginx?

Before we start typing commands, let's briefly discuss what Nginx (pronounced "engine-ex") is and why it's so important for web developers.

Nginx is a high-performance, open-source web server. While it can serve static files (like HTML, CSS, and images) directly to users, its power in modern web development comes from its ability to act as a reverse proxy.

In your Django development setup, you use a simple server (runserver). This is great for development but not suitable for production. In a production environment, you'll have a more robust application server (like Gunicorn, which we'll cover later) running your Django code. Nginx will sit in front of it, receiving requests from the internet and forwarding them to Gunicorn. It will also handle serving static files directly, taking that load off your Python application.

For today, we'll start simple by installing Nginx and getting it to serve its default static page.

Hands-On: Installing and Running Nginx

Let's get our hands dirty. Follow these steps in your Fedora terminal to get your web server up and running.

The following guide will be our primary reference for the command-line steps. It's a clear, concise walkthrough for installing Nginx on Fedora.

Step 1: Update Your System

It's always good practice to ensure your system's package list is up to date before installing new software. This helps prevent potential conflicts.

sudo dnf upgrade --refresh

Step 2: Install the Nginx Package

Fedora includes Nginx in its default repositories, making installation straightforward with the dnf package manager.

sudo dnf install nginx

After the installation finishes, you can verify that it was installed correctly by checking its version.

nginx -v

You should see output like nginx version: 1.24.0.

Step 3: Configure the Firewall

On Fedora, the firewalld service is running by default and blocks most incoming traffic. Installing Nginx doesn't automatically open the ports it needs. We must explicitly tell the firewall to allow web traffic.

Web traffic uses standard ports:

• Port 80 for HTTP (unencrypted)
• Port 443 for HTTPS (encrypted)

We'll open both, though we will only use HTTP for now.

# Allow HTTP traffic permanently
sudo firewall-cmd --permanent --add-service=http




# Allow HTTPS traffic permanently
sudo firewall-cmd --permanent --add-service=https




# Reload the firewall to apply the new rules
sudo firewall-cmd --reload

The --permanent flag ensures the rules persist after a reboot.

Step 4: Start and Enable the Nginx Service

Now that Nginx is installed and the firewall is configured, we need to start the Nginx service and enable it to launch automatically every time you boot your system. We can do this with a single systemctl command.

sudo systemctl enable nginx --now

• enable ensures the service starts on boot.
• --now starts the service immediately.

You can check its status to make sure everything is working.

systemctl status nginx

You should see Active: active (running) in the output, which confirms the server is operational.

Step 5: Verify in Your Browser

The final test! Nginx should now be serving its default welcome page. Since you are running this on your local machine, you can access it by navigating to localhost.

Open your web browser and go to this address: http://localhost

You should be greeted with the Fedora Nginx test page.

Under the Hood: How It Works

You've successfully started a web server! But what did Nginx actually do? How did it know what page to show?

As a developer, understanding the configuration behind the magic is crucial. This short video gives a great tour of the default Nginx setup.

The key takeaway from the video is that Nginx's behavior is controlled by configuration files, typically located in /etc/nginx/. On Fedora, the default site is defined in /etc/nginx/conf.d/default.conf, which points to the web root at /usr/share/nginx/html.

Conclusion

Excellent work! You have successfully installed and started a production-grade web server on your Fedora system. This is a fundamental skill for any web developer and the first major step in deploying your applications.

Key Takeaways:

• Nginx is a web server that will act as the entry point for your future Django applications.
• Installation on Fedora is done using sudo dnf install nginx.
• You must configure the system firewall (firewalld) to allow http and https traffic.
• The systemctl command is used to manage services like Nginx (enable to start on boot, --now to start immediately).
• The default Nginx configuration serves files from /usr/share/nginx/html.

In our next lesson, we will dive deeper into the Nginx configuration files. You will learn to explore and identify key Nginx configuration blocks (http, server, location). This knowledge will allow you to move beyond the default page and start configuring Nginx to serve your own content.