Today I’d like to demonstrate how to install OpenResty on Ubuntu 20.04 via apt-get
.
We’ll use this fresh install of Ubuntu 20.04 in this video.
We can always goto the openresty.org web site to find the instructions. We can find all the commands for enabling the APT repository and installing the OpenResty Deb packages.
Back to our Ubuntu 20.04 system. If you already have anything listening on the local port 80, then you should disable it.
1 | sudo lsof -i:80 |
Here we don’t have any.
First of all, make sure the system time is correct:
1 | sudo ntpdate -v time.google.com |
You may want to use a different NTP server near you here.
We should install some prerequisites needed by adding GPG public keys. These could be removed later.
1 | sudo apt-get -y install --no-install-recommends wget gnupg ca-certificates |
Let’s import our GPG key:
1 | wget -O - https://openresty.org/package/pubkey.gpg | sudo apt-key add - |
Then add the our official APT repository.
1 | echo "deb http://openresty.org/package/ubuntu $(lsb_release -sc) main" > openresty.list |
Note that this is for an x86_64
or amd64
system.
For Aarch64 or ARM64 systems, you should use this URL instead.
1 | echo "deb http://openresty.org/package/arm64/ubuntu $(lsb_release -sc) main" |
Now update the APT index:
1 | sudo apt-get update |
Note that we need sudo
here.
Now it’s time to install our main RPM package, openresty
.
1 | sudo apt-get -y install --no-install-recommends openresty |
Check if the openresty
executable is available.
1 | which openresty |
This openresty
executable is just a symbolic link.
1 | file `which openresty` |
And check its version.
1 | openresty -V |
We can start the default openresty server like this.
1 | sudo systemctl start openresty |
Check if the nginx processes are up and running.
1 | ps aux|grep nginx |
Perfect.
Test the default home page with the curl
command.
1 | curl 127.0.0.1/ |
Yay, it’s working.
Note, however, that the resty
command-line utility is not installed yet.
1 | which resty |
If you want it, then you can install the openresty-resty
RPM package from the same repository.
1 | sudo apt-get -y install openresty-resty |
Now it should be ready.
1 | which resty |
Similarly, if you want to use the restydoc
command-line utility, you should install the openresty-doc
package.
1 | sudo apt-get -y install openresty-restydoc |
Now it’s available too.
1 | restydoc -s content_by_lua_file |
We can also install OPM for installing more Lua modules contributed by the OpenResty community.
1 | sudo apt-get -y install openresty-opm |
We can try installing the lua-resty-http
library authored by James Hurst.
1 | sudo opm get pintsized/lua-resty-http |
Try loading it with the resty
utility.
1 | resty -e 'require "resty.http"' |
Success!
There is also a debug build of OpenResty which includes debugging logs and all the internal assertions enabled.
1 | sudo apt-get -y install openresty-debug |
We can invoke this debug version of openresty like this.
1 | which openresty-debug |
This openresty-debug
executable is also a symbolic link.
1 | file `which openresty-debug` |
We should never use it in production since it is much slower than the release build.
Furthermore, there are also special builds for checking memory issues via Valgrind.
1 | sudo apt list openresty-valgrind |
Try these when you have memory issues to debug. We may cover these in future tutorials.
To upgrade OpenResty packages to their latest versions, just run these commands.
1 | sudo apt-get update |
To check all the available packages in our openresty repository.
1 | apt list 'openresty*' | less |
We’ve got a lot of binary packages here.
We can find detailed documentation for all these Deb packages on the web pagehttps://openresty.org/en/deb-packages.html. We have indeed got a lot of packages for the user to choose from.
That’s all I’d like to cover today. Have fun!
If you like this tutorial, please subscribe to this blog site and our YouTube channel. Thank you!
About This Article and Associated VideoThis article and its associated video are both generated automatically from a simple screenplay file.
Boost your application's performance by OpenResty XRay
About The AuthorYichun Zhang is the creator of the OpenResty® open source project. He is also the founder and CEO of the OpenResty Inc. company. He contributed a dozen open source Nginx 3rd-party modules, quite some Nginx and LuaJIT core patches, and designed the OpenResty XRay platform.
TranslationsWe provide the Chinese translation for this article on blog.openresty.com.cn. We also welcome interested readers to contribute translations in other natural languages as long as the full article is translated without any omissions. We thank them in advance.
We are hiringWe always welcome talented and enthusiastic engineers to join our team at OpenResty Inc. to explore various open source software’s internals and build powerful analyzers and visualizers for real world applications built atop the open source software. If you are interested, please send your resume totalents@openresty.com
. Thank you!
Try out OpenResty XRay yourself