Install OpenResty on CentOS 8 via dnf
This tutorial will demonstrate how to install OpenResty on CentOS 8 via dnf
.
We’ll use this fresh install of CentOS 8 in this tutorial.
We can always goto the openresty.org web site to find the instructions.
Then click on the Installation link on the left side bar.
And click on the link “official pre-built packages” under the “Binary Packages” section.
As we can see here, we do support a lot of different Linux distributions.
Scroll down to the CentOS section.
We can find all the commands for enabling the yum repository and installing the OpenResty rpm packages.
Back to our CentOS 8 system, first install the standard wget
package if you don’t have it already.
sudo dnf -y install wget
Use wget
to download the openresty.repo
file from our site.
wget 'https://openresty.org/package/centos/openresty.repo'
We move this file into the yum repositories' configuration directory.
sudo mv openresty.repo /etc/yum.repos.d/
Note that we need sudo
here.
We update the yum index database.
sudo dnf check-update
Now it’s time to install our main RPM package, openresty
.
sudo dnf -y install openresty
Check if the openresty
executable is available.
which openresty
This openresty
executable is just a symbolic link.
file `which openresty`
And check its version.
openresty -V
We can start the default openresty server like this.
sudo systemctl start openresty
Check if the nginx processes are up and running.
ps aux|grep nginx
Perfect.
Test the default home page with the curl
command.
curl 127.0.0.1/
Yay, it’s working.
Note, however, that the resty
command-line utility is not installed yet.
which resty
If you want it, then you can install the openresty-resty
RPM package from the same repository.
sudo dnf -y install openresty-resty
Now it should be ready.
which resty
resty -e 'print("Hello Resty")'
Similarly, if you want to use the restydoc
command-line utility, you should install the openresty-doc
package.
sudo dnf -y install openresty-doc
Now it’s available too. Try it out!
restydoc -s content_by_lua_file
We can also install OPM for installing more Lua modules contributed by the OpenResty community.
sudo dnf -y install openresty-opm
We can try installing the lua-resty-http
library authored by James Hurst.
sudo opm get pintsized/lua-resty-http
Try loading it with the resty
utility.
resty -e 'require "resty.http"'
Success!
There is also a debug build of OpenResty which includes debugging logs and all the internal assertions enabled.
sudo dnf -y install openresty-debug
We can invoke this debug version of openresty like this.
which openresty-debug
This openresty-debug
executable is also a symbolic link.
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 and Address Sanitizer.
sudo dnf list openresty-valgrind openresty-asan
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.
sudo dnf check-update
sudo dnf upgrade 'openresty*'
To check all the available packages in our openresty repository.
dnf --disablerepo='*' --enablerepo="openresty" list available
We’ve got a lot of packages here.
We can find detailed documentation for all these RPM packages on the web page openresty.org/en/rpm-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 Video
This article and its associated video are both generated automatically by our OpenResty Showman product from a simple screenplay file.
About The Author
Yichun 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 products like OpenResty Edge, OpenResty XRay, and OpenResty Showman.
Translations
We 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 hiring
We 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 to talents@openresty.com
. Thank you!