Mastering Nginx

(Ron) #1

The NGINX Community


[ 280 ]

IRC channel


The IRC channel #nginx at irc.freenode.net is a real-time resource for those


interested in getting to know the developers and having helpful responses to short


queries. Please do follow IRC etiquette though when visiting the channel. Larger
blocks of text such as configuration files or compilation output should go into a


Pastebin and only the URL copied into the channel. More details about the channel
can be found at http://wiki.nginx.org/IRC.


Web resources


The wiki at http://wiki.nginx.org has been a useful resource for a number of years.
Here you will find a complete directive reference, a module listing, and a number of


configuration examples. Keep in mind though, that this is a wiki, and the information


found on it is not guaranteed to be accurate, up-to-date, or to fit your needs exactly.
As we have seen throughout this book, it is always important to think about what you


want to accomplish before setting out to derive the solution.


NGINX, Inc. maintains the official reference documentation located at http://nginx.


org/en/docs/. There are some documents introducing NGINX, as well as How-to's
and pages describing each module and directive.


Writing a good bug report


When searching for help online, it is useful to be able to write a good bug report.
You will find that an answer is much more easily forthcoming if you can formulate


the problem in a clear, reproducible way. This section will help you do just that.


The most difficult part of a bug report is actually defining the problem itself. It will


help you to first think about what it is you are trying to accomplish. State your goal
in a clear, concise manner as follows:


I need all requests to subdomain.example.com to be served from server1.

Avoid writing reports in the following manner:


I'm getting requests served from the local filesystem instead of
proxying them to server1 when I call subdomain.example.com.

Do you see the difference between these two statements? In the first case, you can
clearly see that there is a specific goal in mind. The second case describes more the


result of the problem than the goal itself.

Free download pdf