First of all, please go to the Download page to get the source code tarball of , and see the Installation page for how to build and install it into your system.

HelloWorld

Prepare directory layout

We first create a separate directory for our experiments. You can use an arbitrary directory. Here for simplicity, we just use :

Note that we’ve also created the logs/ directory for logging files and conf/ for our config files.

  1. error_log logs/error.log;
  2. events {
  3.     worker_connections 1024;
  4. }
  6.     server {
  7.         listen 8080;
  8.             default_type text/html;
  9.             content_by_lua_block {
  10.                 ngx.say("<p>hello, world</p>")
  11.             }
  12.         }
  14. }

If you’re familiar with configuration, it should look very familiar to you. OpenResty is just an enhanced version of by means of addon modules anyway. You can take advantage of all the exisitng goodies in the Nginx world.

Start the Nginx server

Assuming you have installed OpenResty into /usr/local/openresty (this is the default), we make our nginx executable of our installation available in our PATH environment:

Then we start the nginx server with our config file this way:

    We can use curl to access our new web service that says HelloWorld:

    If everything is okay, we should get the output

    1. <p>hello, world</p>

    You can surely point your favorite web browser to the location http://localhost:8080/.

    Test performance

    Where to go from here

    View the documentation of each component at the Components page and find related stuff on the Nginx Wiki site.