Ready to know about downtime before your customers?
Status List delivers uptime monitoring and professional hosted status pages for sites of all shapes and sizes.
Trusted by 1000+ companies
Contents
NGINX server_name: How to use it, Where you need it
Own a website, want to get alerts when it’s not working?
Consider trying out Status List for free. We have thousands of less-stressed customers who rely on us.
The server_name config directive tells NGINX how to route client requests. We can use server_name to match multiple domains, split out IP-based requests and work on localhost.
What server_name does
server_name helps NGINX route requests between multiple server blocks. Server blocks allow you to define backend services and specific ways to handle those requests. The server_name tells NGINX which server block to use.
This directive is really useful for SSL termination and domain based routing. For example, you may want to serve your static files from static.mydomain.com with specific compression settings. But, you may want different compression settings for api.mydomain.com. Server_name can help you with this.
server_name is not required
You can ignore the server_name directive if you wish. This is useful when you don’t need domain routing or you only have one backend service. If you omit the server_name directive, NGINX will simply use the first server block.
server_name _ (underscore)
You can also set server_name to “_”. This is basically the same as omitting the server_name directive. It will mark this server block as the catch-all block.
Using server_name for localhost
For local development or machine tests, you can define a localhost server_name. Any requests to localhost or 127.0.0.1 will be routed to this server block. Here’s an example of how to do this:
server {
server_name: 127.0.0.1 localhost;
}
Using server_name for multiple domains
You can define multiple domains in your server_name directive. Simply list your domains with spaces or newlines between each domain. Don’t forget to end your directive with a semicolon. Here’s an example:
server {
server_name: mydomain.com api.mydomain.com;
}
server {
server_name:
static.mydomain.com
redirects.mydomain.com;
}
Using server_name wildcards
You can also use wildcards. This allows us to match multiple domains without having to explicitly list them. For example you could set your server_name to *.mydomain.com instead of app.mydomain.com api.mydomain.com static.mydomain.com.
Wildcards only work at the start or end of the domain name (e.g. *.domain.com or domain.*). You can’t put a wildcard in the middle of the domain name. For that you will need to use a regular expression.
Using server_name regular expressions
NGINX also supports PCRE compatible regex for the server_name. You can write your regular expressions just like you would a domain name. If you want to enter multiple regular expressions, just add them with a space separating each expression. Here’s a few examples:
server {
server_name ^www\..+\.mydomain\.com$
^static\.my.+\.com$;
}
Using server_name IP Addresses
You can enter IP addresses in the server_name block. IP addresses will match requests where the Host field is an IP address (e.g. http://10.0.0.23/myfile.html). For example:
server {
server_name 10.0.0.2;
}
You may also enjoy
It's important to test your NGINX configuration to prevent downtime. Fortunately it's really easy to test your configuration before reloading.
Config variables are a powerful tool to control how NGINX routes requests. HTTP request, header and env variables give us precise control on request routing.
NGINX makes it easy to run Laravel on a production web server. The setup has a few steps, but it's pretty straight forward. Let's get your app into production!
NGINX is fairly straightforward to install and provides a lot of punch right out of the box. Let's dive in and get started!
Learn to set up the NGINX status page with for real-time server performance monitoring and seamless integration. Let's get your status page up and running!
The server_name config directive tells NGINX how to route client requests. server_name can match multiple domains, split out requests and work on localhost.